Method: accounts.searchChangeHistoryEvents

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

طلب HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

pageSize

integer

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

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 مورد المكوّن المخصّص
CUSTOM_METRIC مورد CustomMetric
DATA_RETENTION_SETTINGS مرجع DataSurveySettings
DATA_STREAM مرجع DataStream
ATTRIBUTION_SETTINGS مرجع AttributionSettings
EXPANDED_DATA_SET المورد ExtendedDataSet
CHANNEL_GROUP مرجع ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS مورد AdvancedMeasurementSettings
DATA_REDACTION_SETTINGS مرجع DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA مرجع SKAdNetwork ConversionValueSchema
AUDIENCE مورد الجمهور
EVENT_CREATE_RULE مرجع EventCreateRule
CALCULATED_METRIC مورد CalculatedMetric

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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

قائمة بالتغييرات التي تم إجراؤها في حدث سجلّ التغييرات هذا والتي تتناسب مع الفلاتر المحدّدة في 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)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // End of list of possible types for union field resource.
}
الحقول

حقل الاتحاد resource.

يمكن أن يكون resource واحدًا فقط مما يلي:

account

object (Account)

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

property

object (Property)

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

googleSignalsSettings

object (GoogleSignalsSettings)

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

conversionEvent

object (ConversionEvent)

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

measurementProtocolSecret

object (MeasurementProtocolSecret)

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

customDimension

object (CustomDimension)

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

customMetric

object (CustomMetric)

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

dataRetentionSettings

object (DataRetentionSettings)

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

dataStream

object (DataStream)

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

attributionSettings

object (AttributionSettings)

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

expandedDataSet

object (ExpandedDataSet)

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

channelGroup

object (ChannelGroup)

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

enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

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

dataRedactionSettings

object (DataRedactionSettings)

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

skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

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

audience

object (Audience)

نبذة عن مرجع شريحة الجمهور في سجلّ التغييرات

eventCreateRule

object (EventCreateRule)

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

calculatedMetric

object (CalculatedMetric)

لقطة لمورد CalculatedMetric في سجل التغييرات.