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-normalized ويستخدم 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-normalized ويستخدم 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

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-normalized ويستخدم 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)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // 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 في سجلّ التغييرات