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

رابط برنامه‌نویسی کاربردی قدیمی حذف کاربر گوگل آنالیتیکس (نسخه ۳) به همراه Universal Analytics منسوخ شده است. رابط برنامه‌نویسی کاربردی مدیریت گوگل آنالیتیکس (نسخه ۱alpha) یک متد SubmitUserDeletion جایگزین برای درخواست حذف داده‌ها برای کاربران در ویژگی‌های گوگل آنالیتیکس ارائه می‌دهد.

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

اگر کد شما هنوز متد upsert از رابط برنامه‌نویسی کاربردی حذف کاربر قدیمی (نسخه ۳) را فراخوانی می‌کند، باید به رابط برنامه‌نویسی کاربردی مدیریت گوگل آنالیتیکس مهاجرت کنید تا حذف کاربران را برای ویژگی‌های گوگل آنالیتیکس خود انجام دهید.

مراحل مهاجرت

برای شروع استفاده از متد جدید 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 کلیک کنید.