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

اختياريّ. اسم المورد لخاصية فرعية في حال ضبطها، سيتم فقط عرض التغييرات التي تم إجراؤها على هذا الموقع أو موارده الفرعية. التنسيق: المواقع/{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 مع الطلب الذي وفّر الرمز المميّز للصفحة.

نص الاستجابة

رسالة استجابة لاستدعاء إجراء عن بُعد (RPC) في SearchAccounts.

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

تمثيل 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 مورد DataStaySettings
DATA_STREAM مرجع مصدر البيانات
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

إذا كانت القيمة true، ستتم فلترة قائمة التغييرات التي تم عرضها، ولا تمثّل جميع التغييرات التي حدثت في هذا الحدث.
changes[]

object (ChangeHistoryChange)

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

ActorType

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

عمليات التعداد
ACTOR_TYPE_UNSPECIFIED نوع الممثل غير معروف أو غير محدّد.
USER التغييرات التي أجراها المستخدم المحدّد في ACTOREmail
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)

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