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 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
EXPANDED_DATA_SET مورد ExpandedDataSet
CHANNEL_GROUP مورد ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings resource
DATA_REDACTION_SETTINGS مورد DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA مصدر SKAdNetworkConversionValueSchema
AUDIENCE مرجع الجمهور
EVENT_CREATE_RULE مورد EventCreateRule
KEY_EVENT مورد KeyEvent
CALCULATED_METRIC مورد CalculatedMetric
REPORTING_DATA_ANNOTATION مورد ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG مورد SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS مورد ReportingIdentitySettings
USER_PROVIDED_DATA_SETTINGS مورد UserProvidedDataSettings

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)
  },
  "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)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  },
  "userProvidedDataSettings": {
    object (UserProvidedDataSettings)
  }
  // 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)

لقطة لمورد 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 في سجلّ التغييرات
keyEvent

object (KeyEvent)

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

object (CalculatedMetric)

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

object (ReportingDataAnnotation)

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

object (SubpropertySyncConfig)

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

object (ReportingIdentitySettings)

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

object (UserProvidedDataSettings)

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