- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- جرِّبه الآن
البحث خلال جميع التغييرات التي تطرأ على حساب أو عناصره الثانوية وفقًا لمجموعة الفلاتر المحدّدة.
طلب HTTP
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
account |
مطلوبة. مورد الحساب المطلوب عرض موارد سجلّ التغييرات له. التنسيق: accounts/{account} مثال: "accounts/100" |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "property": string, "resourceType": [ enum ( |
الحقول | |
---|---|
property |
اختياريّ. اسم المورد لخاصية فرعية في حال ضبطها، سيتم فقط عرض التغييرات التي تم إجراؤها على هذا الموقع أو موارده الفرعية. التنسيق: المواقع/{propertyId} مثال: "properties/100" |
resourceType[] |
اختياريّ. وفي حال ضبطها، لا يتم عرض التغييرات إلا إذا كانت لمورد يتطابق مع نوع واحد على الأقل من هذه الأنواع. |
action[] |
اختياريّ. وفي حال ضبطها، سيتم عرض التغييرات التي تتطابق فقط مع نوع واحد أو أكثر من أنواع الإجراءات هذه. |
actorEmail[] |
اختياريّ. وفي حال ضبطها، لن يتم عرض التغييرات إلا إذا أجراها مستخدم في هذه القائمة. |
earliestChangeTime |
اختياريّ. وفي حال ضبطها، يجب عرض التغييرات التي تم إجراؤها بعد هذه المدة فقط (شاملة). طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
latestChangeTime |
اختياريّ. وفي حال ضبطها، يجب فقط عرض التغييرات التي تم إجراؤها قبل هذا الوقت (شاملةً). طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
pageSize |
اختياريّ. الحد الأقصى لعدد عناصر ChangeHistoryEvent المطلوب عرضها. وقد تعرِض الخدمة أقل من هذه القيمة، حتى في حال توفُّر صفحات إضافية. وفي حال عدم تحديد قيمة السمة، سيتم إرجاع 50 سلعة كحدّ أقصى. القيمة القصوى هي 200 (سيتم فرض القيم الأعلى على الحد الأقصى). |
pageToken |
اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة مع " |
نص الاستجابة
رسالة استجابة لاستدعاء إجراء عن بُعد (RPC) في SearchAccounts.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
الحقول | |
---|---|
changeHistoryEvents[] |
النتائج التي كان بإمكان المتصل الوصول إليها. |
nextPageToken |
هو رمز مميّز يمكن إرساله على أنّه |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
أنواع الموارد التي يمكن عرض تغييراتها من سجلّ التغييرات.
عمليات التعداد | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED |
نوع المورد غير معروف أو لم يتم تحديده. |
ACCOUNT |
مرجع الحساب |
PROPERTY |
مورد الموقع |
FIREBASE_LINK |
مرجع FirebaseLink |
GOOGLE_ADS_LINK |
مرجع GoogleAdsLink |
GOOGLE_SIGNALS_SETTINGS |
مرجع GoogleSignalsSettings |
CONVERSION_EVENT |
مورد ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
مورد MeasurementProtocolSecret |
DATA_RETENTION_SETTINGS |
مورد DataStaySettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
مورد DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
مورد DisplayVideo360AdvertiserLinkProposal |
DATA_STREAM |
مرجع مصدر البيانات |
ATTRIBUTION_SETTINGS |
مرجع AttributionSettings |
ActionType
أنواع الإجراءات التي قد تؤدي إلى تغيير مورد.
عمليات التعداد | |
---|---|
ACTION_TYPE_UNSPECIFIED |
نوع الإجراء غير معروف أو غير محدد. |
CREATED |
تم إنشاء المورد في هذا التغيير. |
UPDATED |
تم تعديل المرجع في هذا التغيير. |
DELETED |
تم حذف المرجع في هذا التغيير. |
ChangeHistoryEvent
مجموعة من التغييرات ضمن حساب "إحصاءات Google" أو مواقعه الفرعية الناتجة عن السبب نفسه. تتمثّل الأسباب الشائعة في إجراء التعديلات على واجهة مستخدِم "إحصاءات Google"، أو التغييرات من فريق دعم العملاء، أو التغييرات التلقائية في نظام "إحصاءات Google".
تمثيل JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
الحقول | |
---|---|
id |
رقم تعريف حدث سجلّ التغييرات هذا. هذا المعرّف فريد في جميع "إحصاءات Google". |
changeTime |
الوقت الذي تم فيه إجراء التغيير طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
actorType |
نوع الممثّل الذي أجرى هذا التغيير |
userActorEmail |
عنوان البريد الإلكتروني لحساب Google الذي أجرى التغيير سيكون هذا عنوان بريد إلكتروني صالحًا إذا تم تعيين حقل الممثل على USER، وسيكون فارغًا بخلاف ذلك. ستؤدي حسابات Google التي تم حذفها إلى حدوث خطأ. |
changesFiltered |
إذا كانت القيمة true، ستتم فلترة قائمة التغييرات التي تم عرضها، ولا تمثّل جميع التغييرات التي حدثت في هذا الحدث. |
changes[] |
قائمة بالتغييرات التي تم إجراؤها في حدث سجلّ التغييرات هذا والتي تتناسب مع الفلاتر المحدّدة في SearchChangeHistoryEventRequest. |
ActorType
الجهات الفاعلة المختلفة التي يمكنها إجراء تغييرات على موارد "إحصاءات Google"
عمليات التعداد | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
نوع الممثل غير معروف أو غير محدّد. |
USER |
التغييرات التي أجراها المستخدم المحدّد في ACTOREmail |
SYSTEM |
التغييرات التي يُجريها نظام "إحصاءات Google". |
SUPPORT |
التغييرات التي أجراها فريق دعم "إحصاءات Google". |
ChangeHistoryChange
وصف للتغيير في مورد واحد في "إحصاءات Google".
تمثيل JSON |
---|
{ "resource": string, "action": enum ( |
الحقول | |
---|---|
resource |
اسم المورد الذي يتم وصف تغييراته من خلال هذا الإدخال. |
action |
نوع الإجراء الذي أدّى إلى تغيير هذا المورد. |
resourceBeforeChange |
محتوى المورد قبل إجراء التغيير إذا تم إنشاء هذا المورد في هذا التغيير، فسيفقد هذا الحقل. |
resourceAfterChange |
محتوى المورد بعد إجراء التغيير إذا تم حذف هذا المورد في هذا التغيير، فلن يكون هذا الحقل متوفرًا. |
ChangeHistoryResource
لقطة لمورد ما قبل أو بعد نتيجة تغيير في سجلّ التغييرات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
account |
لقطة لمورد الحساب في سجلّ التغييرات |
property |
نبذة عن مورد "الموقع" في سجلّ التغييرات |
firebaseLink |
نبذة عن مورد FirebaseLink في سجلّ التغييرات |
googleAdsLink |
نبذة عن مرجع GoogleAdsLink في سجلّ التغييرات |
conversionEvent |
نبذة عن مورد ConversionEvent في سجلّ التغييرات |
measurementProtocolSecret |
نبذة عن مورد MeasurementProtocolSecret في سجلّ التغييرات |
dataRetentionSettings |
نبذة عن مرجع إعدادات الاحتفاظ بالبيانات في سجلّ التغييرات |
dataStream |
نبذة عن مورد مصدر البيانات في سجلّ التغييرات |