Method: accounts.searchChangeHistoryEvents

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
account

string

مطلوبة. مورد الحساب الذي يعرض موارد سجل التغييرات له.

نص الطلب

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

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

string

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

سجل الموارد ChangeType

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

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

إجراء

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

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

حدث السجلّ

مجموعة من التغييرات في حساب "إحصاءات 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 الذي أجرى التغيير سيكون هذا عنوان بريد إلكتروني صالحًا إذا تم ضبط حقل المُنفِّذ على "المستخدم"، وتركه فارغًا. ستؤدي حسابات Google التي تم حذفها إلى حدوث خطأ.
changesFiltered

boolean

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

object (ChangeHistoryChange)

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

نوع المُنفِّذ

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

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

تغيير السجلّ

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

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

string

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

enum (ActionType)

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

object (ChangeHistoryResource)

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

object (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)

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

object (MeasurementProtocolSecret)

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

object (DataRetentionSettings)

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

object (DataStream)

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