نقل البيانات إلى Google Analytics Admin API لحذف المستخدمين

تم إيقاف الإصدار القديم من User Deletion API في "إحصاءات Google" (الإصدار 3) نهائيًا مع Universal Analytics. توفّر Google Analytics Admin API (الإصدار الأوّلي 1) طريقة بديلة SubmitUserDeletion لطلب حذف بيانات المستخدمين في مواقع "إحصاءات Google".

هل عليّ نقل البيانات؟

إذا كان الرمز البرمجي لا يزال يستدعي الطريقة upsert من الإصدار القديم من User Deletion API (الإصدار 3)، عليك نقل البيانات إلى Google Analytics Admin API لإجراء عمليات حذف المستخدمين لمواقعك على "إحصاءات Google".

خطوات نقل البيانات

اتّبِع الخطوات التالية لبدء استخدام طريقة SubmitUserDeletion الجديدة.

تفعيل Google Analytics Admin API

انقر على الزر تفعيل Google Analytics Admin API التالي لاختيار مشروع جديد أو إنشائه وتفعيل Google Analytics Admin API تلقائيًا.

البحث عن طلبات البيانات من واجهة برمجة التطبيقات القديمة User Deletion API واستبدالها

استبدِل أي طلبات إلى الطريقة القديمة upsert في واجهة برمجة التطبيقات القديمة لحذف بيانات المستخدمين بطلبات إلى الطريقة الجديدة SubmitUserDeletion في Google Analytics Admin API.

مثال على طلب upsert لواجهة برمجة التطبيقات القديمة User Deletion API:

  POST https://analytics.googleapis.com/analytics/v3/userDeletion/userDeletionRequests:upsert
  {
    "propertyId": "1234567",
    "id": {
      "type": "USER_ID",
      "userId": "user123"
    }
  }

مثال على طلب مكافئ لواجهة SubmitUserDeletion Google Analytics Admin API:

  POST https://analyticsadmin.googleapis.com/v1alpha/properties/1234567:submitUserDeletion
  {
    "userId": "user123"
  }

تعديل نطاقات OAuth المطلوبة

يستخدم الإصدار الجديد SubmitUserDeletion من Google Analytics Admin API النطاق https://www.googleapis.com/auth/analytics.edit.

يختلف ذلك عن واجهة برمجة التطبيقات القديمة User Deletion API التي كانت تستخدم النطاق https://www.googleapis.com/auth/analytics.user.deletion.

عليك تعديل أي رموز أو أوامر طلب رموز مميّزة للوصول تستخدم https://www.googleapis.com/auth/analytics.user.deletion لطلب https://www.googleapis.com/auth/analytics.edit بدلاً من ذلك.

إذا كنت تستخدم مكتبة عميل، من المفترض أن تطلب النطاقات اللازمة تلقائيًا.

إيقاف واجهة برمجة التطبيقات القديمة

بعد تعديل الرمز البرمجي لاستخدام طريقة SubmitUserDeletion، يمكنك إيقاف واجهة برمجة التطبيقات القديمة في مشروعك على Google Cloud.

افتح الرابط التالي لفتح نقطة نهاية واجهة برمجة التطبيقات القديمة في Universal Analytics في Google Cloud Console. اختَر مشروعك على السحابة الإلكترونية وانقر على الزر إيقاف واجهة برمجة التطبيقات.