Method: properties.submitUserDeletion

يرسل طلبًا بحذف مستخدم من موقع.

طلب HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{name=properties/*}:submitUserDeletion

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم الموقع الذي سيتم إرسال طلب حذف بيانات المستخدمين إليه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{

  // Union field user can be only one of the following:
  "userId": string,
  "clientId": string,
  "appInstanceId": string,
  "userProvidedData": string
  // End of list of possible types for union field user.
}
الحقول
حقل الدمج user يجب أن يكون المستخدم الذي يرسل طلب حذف user أحد ما يلي:
userId

string

معرّف المستخدم في "إحصاءات Google"
clientId

string

معرّف العميل في "إحصاءات Google"
appInstanceId

string

معرّف مثيل التطبيق في Firebase
userProvidedData

string

البيانات المقدَّمة من المستخدم يمكن أن يحتوي على عنوان بريد إلكتروني واحد أو رقم هاتف واحد.

يجب تسوية عناوين البريد الإلكتروني على النحو التالي:

  • أحرف صغيرة
  • إزالة النقاط قبل علامة @ في عناوين gmail.com/googlemail.com
  • إزالة كل المسافات

يجب أن يتم توحيد تنسيق أرقام الهواتف على النحو التالي:

  • إزالة جميع الأحرف غير الرقمية
  • إضافة البادئة +

نص الاستجابة

رسالة الردّ على طلب إجراء عن بُعد (RPC) لإرسال طلب حذف مستخدم

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deletionRequestTime": string
}
الحقول
deletionRequestTime

string (Timestamp format)

تحدّد هذه السمة الوقت الذي يجب فيه حذف جميع بيانات الزوّار قبل هذه النقطة. يتم ضبط هذا الحقل على الوقت الذي تم فيه تلقّي طلب الحذف.

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/analytics.edit