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. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
pageSize

integer

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

يُرجى العِلم أنّ الخدمة قد تعرض صفحة تتضمّن عددًا أقل من العناصر التي تحدّدها هذه القيمة (وربما صفرًا)، وقد تظل هناك صفحات إضافية. إذا كنت تريد عددًا معيّنًا من العناصر، عليك مواصلة طلب صفحات إضافية باستخدام pageToken إلى أن تحصل على العدد المطلوب.
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
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. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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

إذا كانت القيمة true، يعني ذلك أنّه تم فلترة قائمة التغييرات التي تم عرضها، وهي لا تمثّل جميع التغييرات التي حدثت في هذا الحدث.
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 في سجلّ التغييرات