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

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

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

تمثيل 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 مورد DataRetentionSettings
DATA_STREAM مورد DataStream
ATTRIBUTION_SETTINGS مرجع AttributionSettings
EXPANDED_DATA_SET مورد ExpandedDataSet
CHANNEL_GROUP مورد ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS مرجع EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS مورد DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA مورد SKAdNetworkConversionValueSchema
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)

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

يستخدم معيار 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

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

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

object (GoogleSignalsSettings)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (CustomDimension)

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

object (CustomMetric)

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

object (DataRetentionSettings)

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

object (DataStream)

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

object (AttributionSettings)

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

object (ExpandedDataSet)

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

object (ChannelGroup)

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

object (EnhancedMeasurementSettings)

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

object (DataRedactionSettings)

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

object (SKAdNetworkConversionValueSchema)

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

object (Audience)

لقطة شاشة لمصدر جمهور في سجلّ التغييرات
eventCreateRule

object (EventCreateRule)

لقطة لوحدة EventCreateRule في سجلّ التغييرات
calculatedMetric

object (CalculatedMetric)

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