Method: accounts.searchChangeHistoryEvents

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

فقط زیرمجموعه تغییرات پشتیبانی شده توسط API را برمی گرداند. UI ممکن است تغییرات اضافی را برگرداند.

درخواست HTTP

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

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

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

پارامترها
account

string

مورد نیاز. منبع حسابی که برای بازگرداندن منابع تاریخچه تغییرات. قالب: حساب‌ها/{حساب}

مثال: 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

resource Type[]

enum ( ChangeHistoryResourceType )

اختیاری. در صورت تنظیم، فقط در صورتی تغییرات را برگردانید که برای منبعی باشد که حداقل با یکی از این انواع مطابقت داشته باشد.

action[]

enum ( ActionType )

اختیاری. در صورت تنظیم، فقط تغییراتی را برگردانید که با یک یا چند مورد از این نوع عملکردها مطابقت دارند.

actor Email[]

string

اختیاری. در صورت تنظیم، فقط در صورتی تغییرات را برگردانید که توسط کاربری در این لیست انجام شده باشد.

earliest Change Time

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" .

latest Change Time

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" .

page Size

integer

اختیاری. حداکثر تعداد موارد ChangeHistoryEvent برای بازگشت. اگر نامشخص باشد، حداکثر 50 مورد عودت داده می شود. حداکثر مقدار 200 است (مقادیر بالاتر به حداکثر اعمال می شود).

توجه داشته باشید که این سرویس ممکن است صفحه ای را با موارد کمتر از مقدار مشخص شده (احتمالاً حتی صفر) برگرداند و ممکن است هنوز صفحات اضافی وجود داشته باشد. اگر تعداد خاصی از آیتم ها را می خواهید، باید به درخواست صفحات اضافی با استفاده از pageToken ادامه دهید تا زمانی که تعداد مورد نیاز را بدست آورید.

page Token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی accounts.searchChangeHistoryEvents . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به accounts.searchChangeHistoryEvents باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

بدن پاسخگو

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

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

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

object ( ChangeHistoryEvent )

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

next Page Token

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 منبع
CUSTOM_DIMENSION منبع CustomDimension
CUSTOM_METRIC منبع CustomMetric
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 منحصر به فرد است.

change Time

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" .

actor Type

enum ( ActorType )

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

user Actor Email

string

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

changes Filtered

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 )

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

resource Before Change

object ( ChangeHistoryResource )

محتوای منابع مربوط به قبل از ایجاد تغییر است. اگر این منبع در این تغییر ایجاد شده باشد، این فیلد وجود ندارد.

resource After Change

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 در تاریخچه تغییرات.

conversion Event

object ( ConversionEvent )

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

measurement Protocol Secret

object ( MeasurementProtocolSecret )

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

data Retention Settings

object ( DataRetentionSettings )

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

data Stream

object ( DataStream )

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