تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا المستند كيفية حذف البيانات المرتبطة برقم تعريف مستخدم معيّن باستخدام واجهة برمجة التطبيقات User Deletion API في "إحصاءات Google". هذه الأداة هي واحدة من عدة أدوات متوفرة لمساعدتك في حماية
بياناتك.
يمكنك استخدام مشاريع Firebase أو مواقع "إحصاءات Google" لإرسال طلبات UserDeletion API. يجب توفُّر نطاق
https://www.googleapis.com/auth/analytics.user.deletion 2.0 للطلبات الواردة في هذا الدليل.
إرسال طلب حذف
استخدِم الأسلوب
upsert
لطلب حذف بيانات مستخدم معيّن. تأخذ طريقة upsert
a
userDeletionRequest
كمَعلمتها الوحيدة.
حدِّد المستخدم الذي تريد حذف بياناته من خلال ضبط أحد أرقام التعريف داخل الحقل id.userId. يجب تحديد نوع المعرّف داخل الحقل id.type.
في ما يلي قائمة بأنواع أرقام تعريف المستخدمين المتوافقة:
CLIENT_ID: معرّف العميل في "إحصاءات Google" (متاح فقط عند ضبط الحقل
propertyId).
USER_ID: User
ID في "إحصاءات Google" (متاح فقط عند ضبط الحقل
propertyId).
APP_INSTANCE_ID: رقم تعريف مثيل تطبيق في Firebase
(لا يتوفّر هذا الخيار إلا عند ضبط الحقل firebaseProjectId أو propertyId).
لا يعالج كل طلب لحذف البيانات سوى رقم التعريف الذي تم إرساله في ذلك الطلب.
إذا كانت لديك أرقام تعريف متعددة مرتبطة بالمستخدم نفسه، عليك إرسال طلبات حذف منفصلة لكل رقم تعريف مرتبط بهذا المستخدم. إذا كنت تستخدم أداة BigQuery
export، عليك أيضًا معالجة عمليات الحذف الخاصة بك هناك.
تُعرِض الطريقة
upsertمصدر طلب حذف مستخدم
مع ضبط الحقل deletionRequestTime. يُعلمك حقل deletionRequestTime
بالوقت الذي تلقّت فيه "إحصاءات Google" طلب الحذف.
بعد طلب الحذف، ستتم إزالة البيانات المرتبطة برقم تعريف المستخدِم
من تقرير المستخدِم الفردي خلال 72 ساعة، ثم سيتم حذفها من خوادم
"إحصاءات Google" أثناء عملية الحذف التالية. وتتم جدولة إجراء عمليات الحذف كل شهرَين. في حال تصدير بيانات المستخدمين خارج "إحصاءات Google"، نقترح عليك حذفها أولاً.
تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Analytics User Deletion API allows you to delete data associated with a specific user ID, helping safeguard user data.\u003c/p\u003e\n"],["\u003cp\u003eData is removed from the Individual User Report within 72 hours of the request and permanently deleted from Analytics servers within two months.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.user.deletion\u003c/code\u003e OAuth 2.0 scope and utilizes the \u003ccode\u003eupsert\u003c/code\u003e method for deletion requests.\u003c/p\u003e\n"],["\u003cp\u003eSupported user ID types for deletion include \u003ccode\u003eCLIENT_ID\u003c/code\u003e, \u003ccode\u003eUSER_ID\u003c/code\u003e, and \u003ccode\u003eAPP_INSTANCE_ID\u003c/code\u003e, requiring separate requests for each ID associated with a user.\u003c/p\u003e\n"],["\u003cp\u003eIt's crucial to note that the API doesn't remove previously aggregated data or data exported to external platforms like BigQuery, requiring separate deletion processes.\u003c/p\u003e\n"]]],["The Google Analytics User Deletion API allows deletion of user data using the `upsert` method with a `userDeletionRequest`. Specify the user's ID ( `CLIENT_ID`, `USER_ID`, or `APP_INSTANCE_ID`) and its type. Each ID requires a separate request. Data is removed from the Individual User Report within 72 hours and from Analytics servers within two months, but not from aggregated reports or external exports. OAuth 2.0 scope `https://www.googleapis.com/auth/analytics.user.deletion` is necessary.\n"],null,["# Delete user data\n\nThis document explains how you can delete data associated with a given user ID\nusing the Google Analytics User Deletion API. This tool is one of several tools\navailable to help you [safeguard your\ndata](//support.google.com/analytics/answer/6004245).\n| **Important:** The User Deletion API doesn't remove data from reports based on previously aggregated data, such as user counts in the audience overview report, or from other places you may have exported data to, such as BigQuery.\n\nFor more details, see the [reference\ndocumentation](/analytics/devguides/config/userdeletion/v3/reference).\n\nYou can use Firebase projects or Google Analytics properties to send User\nDeletion API requests. The\n**https://www.googleapis.com/auth/analytics.user.deletion** OAuth 2.0 scope is\nrequired for the requests in this guide.\n\nSend a deletion request\n-----------------------\n\nUse the\n[`upsert`](/analytics/devguides/config/userdeletion/v3/reference/userDeletion/userDeletionRequest/upsert)\nmethod to request the data deletion for a given user. The `upsert` method takes\na\n[`userDeletionRequest`](/analytics/devguides/config/userdeletion/v3/reference/userDeletion/userDeletionRequest)\nas its only parameter.\n\nSpecify the user whose data you want to delete by setting one of the IDs inside\nthe `id.userId` field. The type of the ID must be specified inside the `id.type`\nfield.\n\nHere's a list of supported user ID types:\n\n- `CLIENT_ID`: Google Analytics [client\n ID](//support.google.com/analytics/answer/11593727) (only supported when `propertyId` field is set).\n- `USER_ID`: Google Analytics [User\n ID](//firebase.google.com/docs/analytics/userid) (only supported when `propertyId` field is set).\n- `APP_INSTANCE_ID`: Firebase [application instance ID](//firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.html#getAppInstanceId) (only supported when `firebaseProjectId` or `propertyId` field is set).\n\nEach data deletion request processes only the ID submitted in that request.\n\nIf you have multiple IDs associated with the same user, you must submit separate\ndeletion requests for each ID associated with that user. If you Use BigQuery\nexport, you must also process your own deletions there.\n\nLearn more about [user IDs](//support.google.com/analytics/answer/9213390).\n\nDeletion timeline\n-----------------\n\nThe\n[upsert](/analytics/devguides/config/userdeletion/v3/reference/userDeletion/userDeletionRequest/upsert)\nmethod returns a [User Deletion Request\nResource](/analytics/devguides/config/userdeletion/v3/reference/userDeletion/userDeletionRequest)\nwith the `deletionRequestTime` field set. The `deletionRequestTime` field tells\nyou the time at which the deletion request was received by Google Analytics.\n\nOnce deletion is requested, data associated with the user ID will be removed\nfrom the Individual User Report within 72 hours, and then deleted from Analytics\nservers during the next deletion process. Deletion processes are scheduled to\noccur every two months. If you have exported the user data outside of Google\nAnalytics, we recommend you delete it there first."]]
