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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول Offsets غير "Z". على سبيل المثال: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول Offsets غير "Z". على سبيل المثال: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
pageSize

integer

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

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

string

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

نص الاستجابة

رسالة الردّ على طلب البحث عن الحسابات من خلال استدعاء إجراء عن بُعد

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

تمثيل 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
CUSTOM_DIMENSION مورد CustomDimension
CUSTOM_METRIC مورد CustomMetric
DATA_RETENTION_SETTINGS مورد DataRetentionSettings
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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول Offsets غير "Z". على سبيل المثال: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

نوع الفاعل الذي أجرى هذا التغيير.
userActorEmail

string

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

boolean

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

object (ChangeHistoryChange)

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

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)

لقطة لأحد موارد DataStream في سجلّ التغييرات