Method: accounts.searchChangeHistoryEvents

با توجه به مجموعه فیلترهای مشخص شده، تمام تغییرات یک حساب یا فرزندان آن را جستجو می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 "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 باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

بدن پاسخگو

پیام پاسخ برای SearchAccounts RPC.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
فیلدها
changeHistoryEvents[]

object ( ChangeHistoryEvent )

نتایجی که برای تماس گیرنده قابل دسترسی بود.

nextPageToken

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

انواع منابعی که تغییرات آنها ممکن است از تاریخچه تغییرات بازگردانده شود.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED نوع منبع ناشناخته یا مشخص نشده است.
ACCOUNT منبع حساب
PROPERTY منبع اموال
GOOGLE_SIGNALS_SETTINGS منبع GoogleSignalsSettings
CONVERSION_EVENT منبع ConversionEvent
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret منبع
DATA_RETENTION_SETTINGS منبع DataRetentionSettings
DATA_STREAM منبع DataStream
ATTRIBUTION_SETTINGS منبع AttributionSettings

نوع اقدام

انواع اقداماتی که ممکن است یک منبع را تغییر دهد.

Enums
ACTION_TYPE_UNSPECIFIED نوع اقدام ناشناخته یا مشخص نشده است.
CREATED منبع در این تغییر ایجاد شد.
UPDATED منبع در این تغییر به روز شد.
DELETED منبع در این تغییر حذف شد.

ChangeHistoryEvent

مجموعه‌ای از تغییرات در حساب Google Analytics یا ویژگی‌های فرزند آن که ناشی از همین علت است. دلایل رایج به‌روزرسانی‌های ایجاد شده در رابط کاربری Google Analytics، تغییرات ناشی از پشتیبانی مشتری یا تغییرات خودکار سیستم Google Analytics است.

نمایندگی JSON 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
فیلدها
id

string

شناسه این رویداد تاریخچه تغییر. این شناسه در سراسر Google Analytics منحصر به فرد است.

changeTime

string ( Timestamp format)

زمانی که تغییر ایجاد شد.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

actorType

enum ( ActorType )

نوع بازیگری که این تغییر را ایجاد کرد.

userActorEmail

string

آدرس ایمیل حساب Google که این تغییر را ایجاد کرده است. اگر قسمت بازیگر روی USER تنظیم شده باشد، این یک آدرس ایمیل معتبر خواهد بود و در غیر این صورت خالی خواهد بود. اکانت های گوگل که حذف شده اند باعث خطا می شوند.

changesFiltered

boolean

اگر درست باشد، لیست تغییرات بازگشتی فیلتر شده است و همه تغییراتی را که در این رویداد رخ داده است را نشان نمی دهد.

changes[]

object ( ChangeHistoryChange )

فهرستی از تغییرات ایجاد شده در این رویداد تاریخچه تغییر که متناسب با فیلترهای مشخص شده در SearchChangeHistoryEventsRequest است.

ActorType

انواع مختلفی از بازیگران که می توانند در منابع Google Analytics تغییراتی ایجاد کنند.

Enums
ACTOR_TYPE_UNSPECIFIED نوع بازیگر نامشخص یا نامشخص.
USER تغییرات ایجاد شده توسط کاربر مشخص شده در actorEmail.
SYSTEM تغییرات ایجاد شده توسط سیستم Google Analytics.
SUPPORT تغییرات ایجاد شده توسط کارکنان تیم پشتیبانی Google Analytics.

Change HistoryChange

شرح تغییر در یک منبع Google Analytics.

نمایندگی 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)
  },
  "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 )

یک عکس فوری از یک منبع Property در تاریخچه تغییرات.

conversionEvent

object ( ConversionEvent )

یک عکس فوری از یک منبع ConversionEvent در تاریخچه تغییرات.

measurementProtocolSecret

object ( MeasurementProtocolSecret )

یک عکس فوری از یک منبع MeasurementProtocolSecret در تاریخچه تغییرات.

dataRetentionSettings

object ( DataRetentionSettings )

یک عکس فوری از یک منبع تنظیمات حفظ داده در تاریخچه تغییرات.

dataStream

object ( DataStream )

یک عکس فوری از یک منبع DataStream در تاریخچه تغییرات.