Method: accounts.searchChangeHistoryEvents

البحث في جميع التغييرات التي تم إجراؤها على حساب أو عناصره الثانوية وفقًا لمجموعة الفلاتر المحددة.

طلب HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

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

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

المَعلمات
account

string

مطلوبة. مورد الحساب المطلوب عرض موارد سجلّ التغييرات له. التنسيق: accounts/{account} مثال: "accounts/100"

نص الطلب

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

تمثيل JSON
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
الحقول
property

string

اختياريّ. اسم المورد لخاصية فرعية. في حال ضبطها، لا يتم عرض سوى التغييرات التي تم إجراؤها على هذا الموقع أو موارده الفرعية. التنسيق: Property/{propertyId} مثال: "properties/100"

resourceType[]

enum (ChangeHistoryResourceType)

اختياريّ. في حال ضبطها، لن يتم عرض التغييرات إلا إذا كانت لمورد يتطابق مع نوع واحد على الأقل من هذه الأنواع.

action[]

enum (ActionType)

اختياريّ. وفي حال ضبطها، لن يتم عرض سوى التغييرات التي تتطابق مع نوع واحد أو أكثر من أنواع الإجراءات هذه.

actorEmail[]

string

اختياريّ. وفي حال ضبطها، لن يتم عرض التغييرات إلا إذا أجراها مستخدم في هذه القائمة.

earliestChangeTime

string (Timestamp format)

اختياريّ. وفي حال ضبطها، لا يتم عرض سوى التغييرات التي تم إجراؤها بعد هذه الفترة (شاملة).

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

latestChangeTime

string (Timestamp format)

اختياريّ. وفي حال ضبطها، لن يتم عرض سوى التغييرات التي تم إجراؤها قبل هذه الفترة (شاملة).

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

pageSize

integer

اختياريّ. الحد الأقصى لعدد عناصر ChangeHistoryEvent المطلوب عرضها. وقد تعرِض الخدمة أقل من هذه القيمة، حتى في حال توفُّر صفحات إضافية. وفي حال عدم تحديد قيمة السمة، سيتم إرجاع 50 سلعة كحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم فرض القيم الأعلى على الحد الأقصى).

pageToken

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ accounts.searchChangeHistoryEvents. قم بإدخاله لاسترداد الصفحة التالية. عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى accounts.searchChangeHistoryEvents مع الطلب الذي قدَّم الرمز المميّز للصفحة.

نص الاستجابة

رسالة رد لـ SearchAccounts RPC.

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

تمثيل JSON
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
الحقول
changeHistoryEvents[]

object (ChangeHistoryEvent)

النتائج التي كان بإمكان المتصل الوصول إليها.

nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية إذا تم حذف هذا الحقل، لن تظهر أي صفحات لاحقة.

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

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

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

ChangeHistoryResourceType

أنواع الموارد التي يمكن عرض تغييراتها من سجلّ التغييرات.

عمليات التعداد
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED نوع المورد غير معروف أو غير محدد.
ACCOUNT مرجع الحساب
PROPERTY مصدر الموقع
GOOGLE_SIGNALS_SETTINGS المرجع GoogleSignalsSettings
CONVERSION_EVENT مورد ConversionEvent
MEASUREMENT_PROTOCOL_SECRET مورد MeasurementProtocolSecret
DATA_RETENTION_SETTINGS المورد DataالاحتفاظSettings
DATA_STREAM مرجع DataStream
ATTRIBUTION_SETTINGS مرجع AttributionSettings

ActionType

أنواع الإجراءات التي قد تؤدي إلى تغيير مورد.

عمليات التعداد
ACTION_TYPE_UNSPECIFIED نوع الإجراء غير معروف أو غير محدد.
CREATED تم إنشاء المورد في هذا التغيير.
UPDATED تم تحديث المورد في هذا التغيير.
DELETED تم حذف المرجع في هذا التغيير.

ChangeHistoryEvent

مجموعة من التغييرات ضمن حساب على "إحصاءات Google" أو مواقعه الفرعية التي نتجت عن السبب نفسه. تتمثّل الأسباب الشائعة في إجراء التعديلات في واجهة مستخدِم "إحصاءات Google" أو التغييرات من فريق دعم العملاء أو التغييرات التلقائية في نظام "إحصاءات Google".

تمثيل JSON
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
الحقول
id

string

رقم تعريف حدث سجلّ التغييرات هذا. ويكون هذا المعرّف فريدًا في جميع "إحصاءات Google".

changeTime

string (Timestamp format)

الوقت الذي تم فيه إجراء التغيير.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

actorType

enum (ActorType)

نوع الممثّل الذي أجرى هذا التغيير

userActorEmail

string

عنوان البريد الإلكتروني لحساب Google الذي أجرى التغيير. سيكون هذا عنوان بريد إلكتروني صالحًا إذا تم تعيين حقل الممثل على USER، وسيكون فارغًا بخلاف ذلك. ستتسبب حسابات Google التي تم حذفها في حدوث خطأ.

changesFiltered

boolean

وإذا كانت القيمة صحيحة، يعني ذلك أنّه تمت فلترة قائمة التغييرات التي تم عرضها، ولا تمثّل جميع التغييرات التي حدثت في هذا الحدث.

changes[]

object (ChangeHistoryChange)

قائمة بالتغييرات التي تم إجراؤها في حدث سجلّ التغييرات هذا التي تلائم الفلاتر المحدّدة في SearchChangeHistoryEventRequest.

ActorType

أنواع مختلفة من الجهات الفاعلة التي يمكنها إجراء تغييرات على موارد "إحصاءات Google".

عمليات التعداد
ACTOR_TYPE_UNSPECIFIED نوع المنفِّذ غير معروف أو غير محدّد.
USER التغييرات التي أجراها المستخدم المحدّد في activityEmail
SYSTEM التغييرات التي يُجريها نظام "إحصاءات Google".
SUPPORT التغييرات التي أجراها فريق دعم "إحصاءات Google".

ChangeHistoryChange

وصف للتغيير في مورد واحد في "إحصاءات Google".

تمثيل JSON
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
الحقول
resource

string

اسم المورد الذي يتم وصف تغييراته من خلال هذا الإدخال.

action

enum (ActionType)

نوع الإجراء الذي أدّى إلى تغيير هذا المورد.

resourceBeforeChange

object (ChangeHistoryResource)

محتوى المورد من قبل إجراء التغيير. إذا تم إنشاء هذا المورد في هذا التغيير، فسيكون هذا الحقل مفقودًا.

resourceAfterChange

object (ChangeHistoryResource)

محتويات المورد بعد إجراء التغيير. إذا تم حذف هذا المورد في هذا التغيير، فسيكون هذا الحقل مفقودًا.

ChangeHistoryResource

لقطة لمورد قبل أو بعد نتيجة حدوث تغيير في سجلّ التغييرات.

تمثيل JSON
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
الحقول

حقل الاتحاد resource

يمكن أن تكون السمة "resource" واحدة فقط مما يلي:

account

object (Account)

نبذة عن مورد الحساب في سجلّ التغييرات

property

object (Property)

نبذة عن مورد "الموقع" في سجلّ التغييرات

conversionEvent

object (ConversionEvent)

نبذة عن مورد ConversionEvent في سجلّ التغييرات

measurementProtocolSecret

object (MeasurementProtocolSecret)

نبذة عن مورد MeasurementProtocolSecret في سجلّ التغييرات

dataRetentionSettings

object (DataRetentionSettings)

نبذة عن مورد إعدادات الاحتفاظ بالبيانات في سجلّ التغييرات

dataStream

object (DataStream)

نبذة عن مورد DataStream في سجلّ التغييرات