Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

تستخدم العديد من خدمات Firebase معرّفات المثيلات لتشغيل ميزاتها:

  • تحليلات
  • كراشليتيك
  • المراسلة السحابية
  • التكوين عن بعد

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

الخدمات التي تستخدم معرفات المثيلات لتحديد التثبيتات تستخدمها أيضًا كمفتاح لربط البيانات ذات الصلة بهذا الجهاز. على سبيل المثال ، يستخدم Crashlytics معرفات المثيلات لتسجيل الأعطال التي تحدث على الجهاز ، ويستخدمها Remote Config لجلب التكوينات ، ويستخدم Analytics معرفات المثيلات لتتبع جماهير معينة.

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

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

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

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

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

حذف معرّف باستدعاء عميل API

لحذف المعرفات التي تم إنشاؤها بواسطة خدمات Firebase ، اتصل بالطريقة المناسبة من Firebase Instance ID API:

سويفت

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

ج موضوعية

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

ذكري المظهر

FirebaseInstanceId.deleteInstanceId();

حذف معرّف باستدعاء خادم API

لحذف معرّف مثيل مع استدعاءات API للخادم ، أضف Firebase Admin SDK إلى خادمك ، إذا لم تكن قد فعلت ذلك بالفعل.

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

Node.js

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

admin.instanceId().deleteInstanceId(idToDelete);

جافا

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

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

بايثون

  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)

اذهب

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)
}

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

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

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

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

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

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