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

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

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

تمثيل 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 مرجع DataSurveySettings
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)

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

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)

لقطة شاشة لمورد Property في سجلّ التغييرات
conversionEvent

object (ConversionEvent)

لقطة شاشة لمورد ConversionEvent في سجلّ التغييرات
measurementProtocolSecret

object (MeasurementProtocolSecret)

لقطة شاشة لمرجع MeasurementProtocolSecret في سجلّ التغييرات
dataRetentionSettings

object (DataRetentionSettings)

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

object (DataStream)

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