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

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

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

  • Analytics
  • Crashlytics
  • Cloud Messaging
  • Remote Config

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

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

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

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

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

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

تنشئ خدمة معرّف المثيل معرّفًا جديدًا في غضون بضعة أيام، ما لم إيقاف كل خدمات إنشاء مثيلات-ID في تطبيقك يعتبر 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);

جافا

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

انتقال

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 على الفور معرّفًا مستقلاً وجديدًا، يمكنك استخدام إحدى واجهات برمجة تطبيقات العميل المذكورة أعلاه معالجة الحذف.

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

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

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

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