مهاجرت از API حذف کاربر گوگل آنالیتیکس

API قدیمی حذف کاربر گوگل آنالیتیکس از بین می‌رود. API مدیریت گوگل آنالیتیکس یک متد SubmitUserDeletion جایگزین برای درخواست حذف داده‌ها برای یک کاربر خاص ارائه می‌دهد.

آیا نیاز به مهاجرت دارم؟

اگر کد شما متد upsert از API قدیمی حذف کاربر را فراخوانی می‌کند، برای ادامه استفاده از قابلیت حذف کاربر، باید کد خود را منتقل کنید.

مراحل مهاجرت

برای شروع استفاده از متد جدید SubmitUserDeletion ، این مراحل را دنبال کنید.

فعال کردن API مدیریت گوگل آنالیتیکس

برای انتخاب یا ایجاد یک پروژه جدید Google Cloud و فعال کردن خودکار API مدیریت Google Analytics، روی دکمه «فعال کردن API مدیریت Google Analytics» که در زیر آمده است، کلیک کنید.

فعال کردن API مدیریت گوگل آنالیتیکس

فراخوانی‌های مربوط به API حذف کاربر قدیمی را پیدا و جایگزین کنید

هرگونه فراخوانی به متد upsert قدیمی از API قدیمی حذف کاربر را با فراخوانی به متد جدید SubmitUserDeletion از API مدیریت گوگل آنالیتیکس جایگزین کنید.

مثال درخواست upsert به API حذف کاربر قدیمی:

استراحت

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

مثالی از یک درخواست معادل SubmitUserDeletion از API مدیریت گوگل آنالیتیکس:

استراحت

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

به‌روزرسانی دامنه‌های OAuth درخواستی

تابع جدید SubmitUserDeletion در رابط برنامه‌نویسی کاربردی مدیریت گوگل آنالیتیکس از محدوده‌ی https://www.googleapis.com/auth/analytics.edit استفاده می‌کند.

این با API حذف کاربر قدیمی که از محدوده https://www.googleapis.com/auth/analytics.user.deletion استفاده می‌کرد، متفاوت است.

شما باید هر کد یا دستور درخواست توکن دسترسی که https://www.googleapis.com/auth/analytics.user.deletion استفاده می‌کند را به‌روزرسانی کنید و به جای آن https://www.googleapis.com/auth/analytics.edit درخواست کنید.

اگر از یک کتابخانه کلاینت استفاده می‌کنید، باید به طور خودکار محدوده‌های لازم را درخواست کند.

غیرفعال کردن API قدیمی

پس از اینکه کد خود را برای استفاده از متد SubmitUserDeletion به‌روزرسانی کردید، آماده‌اید تا API قدیمی را در پروژه Google Cloud خود غیرفعال کنید.

برای باز کردن نقطه پایانی Universal Analytics API قدیمی در کنسول Google Cloud خود، لینک زیر را باز کنید. پروژه Cloud خود را انتخاب کرده و روی دکمه Disable API کلیک کنید.