إدارة بيانات رقم تعريف المثيل

تحدِّد أرقام تعريف المثيلات عمليات التثبيت الفردية لتطبيقك. وبما أنّ كل معرّف مثيل فريد لتطبيق وجهاز معيّنَين، فهي تمنح خدمات Firebase طريقة للإشارة إلى مثيلات تطبيق معيّنة. على سبيل المثال، تستخدم خدمة "المراسلة عبر السحابة الإلكترونية" معرّفات المثيلات لتحديد الأجهزة المطلوب إرسال الرسائل إليها.

تستخدم العديد من خدمات Firebase أرقام تعريف المثيلات لتعزيز ميزاتها:

  • إحصاءات Google
  • Crashlytics
  • خدمة المراسلة عبر السحابة الإلكترونية
  • الإعداد عن بُعد

إدارة بيانات التطبيق المرتبطة بأرقام تعريف المثيلات

إنّ الخدمات التي تستخدم أرقام تعريف المثيلات لتحديد عمليات التثبيت تستخدمها أيضًا كمفتاح لربط البيانات ذات الصلة بهذا الجهاز. على سبيل المثال، يستخدم Crashlytics أرقام تعريف المثيلات لتسجيل الأعطال التي تحدث على الجهاز، وتستخدمها ميزة "الإعداد عن بُعد" لجلب الإعدادات، في حين تستخدم "إحصاءات Google" أرقام تعريف المثيلات لتتبُّع شرائح جمهور معيّنة.

بشكل عام، لا تتيح البيانات المرتبطة بمعرّفات المثيلات تحديد الهوية الشخصية، ولكن قد يكون من المفيد منح المستخدمين خيار إدارتها. وفي سبيل تحقيق ذلك، يوفّر Firebase طريقتين لإدارة جمع البيانات ذات الصلة بالمعرّف المثيل:

  • احذف أرقام تعريف المثيلات. يمكنك حذف "معرّف المثيل" من خلال طلب بيانات من واجهة برمجة التطبيقات من جهة الخادم أو من جهة العميل. يؤدي حذف رقم تعريف المثيل إلى حذف رقم التعريف نفسه وجميع البيانات المرتبطة به.
  • أوقِف الخدمات التي تُنشئ أرقام التعريف. إنّ معظم خدمات Firebase التي تستخدم أرقام تعريف المثيلات تنشئ تلقائيًا معرّفًا جديدًا تلقائيًا في حال عدم توفّر معرّف على الجهاز عند بدء تشغيله. لضمان عدم إنشاء تطبيقك لمعرّفات المثيلات غير المرغوب فيها، عليك إيقاف التهيئة التلقائية لهذه الخدمات.

حذف معرّف مثيل

إنّ حذف رقم تعريف مثيل يؤدي أيضًا إلى حذف البيانات المرتبطة برقم التعريف هذا في أي من خدمات Firebase المدرَجة أعلاه. يجعل ذلك حذف المعرّف أداة مفيدة في محو بيانات المستخدم، ولكنه يأتي أيضًا مع تنبيه: إذا كنت تستخدم خدمات متعددة تعتمد على معرّفات المثيلات، فإن حذف المعرّف يؤدي إلى محو البيانات من جميع تلك الخدمات.

تنشئ خدمة "رقم تعريف المثيل" معرِّفًا جديدًا في غضون بضعة أيام، ما لم يتم إيقاف جميع خدمات إنشاء المثيلات الافتراضية في تطبيقك. يعتبر Firebase المعرّف الذي تم إنشاؤه حديثًا مثيلاً جديدًا للتطبيق، ولا يربطه برقم التعريف السابق بأي شكل من الأشكال.

حذف رقم تعريف باستخدام طلب بيانات من واجهة برمجة تطبيقات العميل

لحذف أرقام التعريف التي تم إنشاؤها من خلال خدمات Firebase، يمكنك طلب الطريقة المناسبة من واجهة برمجة تطبيقات معرّف مثيل Firebase كما يلي:

Swift

InstanceID.instanceID().deleteID { error in
  if let error = error {
    print("Error deleting instance ID: \(error)")
  }
}

Objective-C

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
  if error != nil {
    NSLog(@"Error deleting instance ID: %@", error);
  }
}];

Android

FirebaseInstanceId.deleteInstanceId();

حذف رقم تعريف باستخدام طلب بيانات من واجهة برمجة التطبيقات للخادم

لحذف رقم تعريف مثيل باستخدام طلبات البيانات من واجهة برمجة تطبيقات الخادم، أضِف حزمة تطوير البرامج (SDK) لمشرف Firebase إلى الخادم، إذا لم يسبق لك إجراء ذلك.

بعد إضافتها، احذف المعرّفات من خلال استدعاء وظيفة حذف معرّف المثيل باللغة التي تختارها:

Node.js

// An Instance ID sent from a client service SDK
const idToDelete = 'INSTANCE_ID';

admin.instanceId().deleteInstanceId(idToDelete);

Java

// An Instance ID sent from a client service SDK
String idToDelete = "INSTANCE_ID";

FirebaseInstanceId.getInstance().deleteInstanceIdAsync(idToDelete).get();

Python

  from firebase_admin import instance_id

  # An Instance ID sent from a client service SDK
  id_to_delete = 'INSTANCE_ID'

  instance_id.delete_instance_id(id_to_delete)

Go

client, err := app.InstanceId(ctx)
if err != nil {
  log.Fatalln("error initializing client", err)
}

iidToDelete := "INSTANCE_ID"
if err := client.DeleteInstanceId(ctx, iidToDelete); err != nil {
  log.Fatalln("error deleting iid", err)
}

عند حذف رقم تعريف مثيل باستخدام طلب بيانات من واجهة برمجة تطبيقات الخادم، تحذف خدمات Firebase البيانات المرتبطة، وتتوقّف عن قبول البيانات الجديدة لرقم التعريف هذا، وتُعلِم تطبيق العميل خلال بضعة أيام بأنّه تم حذف رقم التعريف. حتى يرسل Firebase إشعارًا إلى تطبيق العميل، قد تواجه بعض خدمات التطبيق انخفاضًا في الوظائف.

إذا كنت تريد حذف معرّف المثيل الحالي واستخدام خدمات Firebase على الفور بمعرّف جديد ومستقل، استخدِم إحدى واجهات برمجة تطبيقات العميل المذكورة أعلاه لمعالجة عملية الحذف.

إيقاف إنشاء رقم تعريف المثيل

تنشئ الخدمات التي تستخدم أرقام التعريف المثيلية تلقائيًا معرّفًا جديدًا عند إعداده في تطبيق لا يحتوي حاليًا على معرّف. عادةً ما يتم تشغيل هذه الخدمات تلقائيًا عند إطلاق التطبيق. لإيقاف إنشاء معرّف المثيل، عليك إيقاف الإعداد التلقائي للخدمات التي تستخدمها.

أحد الأساليب الشائعة هو منح المستخدمين خيار الموافقة على جمع البيانات: إيقاف الإعداد التلقائي للخدمات التي تستخدم أرقام التعريف الافتراضية، وتنفيذ مربّع حوار يطلب من المستخدمين موافقتهم على جمع البيانات، وإعادة تفعيل الخدمات يدويًا بعد الحصول على الموافقة.

اقرأ الأدلّة التالية لمعرفة كيفية إيقاف الإعداد التلقائي للخدمات التي تستخدم رقم تعريف المثيل وإعدادها يدويًا بدلاً من ذلك: