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

ไม่บังคับ ชื่อทรัพยากรของพร็อพเพอร์ตี้ย่อย หากตั้งค่าไว้ จะแสดงการเปลี่ยนแปลงที่เกิดขึ้นกับพร็อพเพอร์ตี้นี้หรือทรัพยากรย่อยเท่านั้น รูปแบบ: พร็อพเพอร์ตี้/{propertyId} เช่น "พร็อพเพอร์ตี้/100"
resourceType[]

enum (ChangeHistoryResourceType)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะส่งคืนค่าการเปลี่ยนแปลงก็ต่อเมื่อมีการเปลี่ยนแปลงสำหรับทรัพยากรที่ตรงกับประเภทเหล่านี้อย่างน้อย 1 ประเภท
action[]

enum (ActionType)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่ตรงกับประเภทการดำเนินการเหล่านี้อย่างน้อย 1 รายการ
actorEmail[]

string

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงการเปลี่ยนแปลงเฉพาะในกรณีที่ดำเนินการโดยผู้ใช้ในรายการนี้
earliestChangeTime

string (Timestamp format)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่เกิดขึ้นหลังจากเวลานี้เท่านั้น (รวม)

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
latestChangeTime

string (Timestamp format)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงผลเฉพาะการเปลี่ยนแปลงที่เกิดขึ้นก่อนเวลานี้เท่านั้น (รวม)

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
pageSize

integer

ไม่บังคับ จำนวนสูงสุดของรายการ ChangeHistoryEvent ที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้แม้ว่าจะมีหน้าเพิ่มเติมก็ตาม หากไม่ระบุ ระบบจะส่งคืนสินค้าไม่เกิน 50 รายการ ค่าสูงสุดคือ 200 (ค่าที่สูงกว่าจะถูกเปลี่ยนเป็นค่าสูงสุด)
pageToken

string

ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการโทร accounts.searchChangeHistoryEvents ครั้งก่อน ระบุข้อมูลนี้เพื่อเรียกหน้าถัดไป เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้ accounts.searchChangeHistoryEvents ต้องตรงกับการเรียกที่ระบุโทเค็นของหน้า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ RPC ของ SearchAccounts

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
ช่อง
changeHistoryEvents[]

object (ChangeHistoryEvent)

ผลลัพธ์ที่ผู้โทรเข้าถึงได้
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อเรียกดูหน้าถัดไปได้ หากเว้นช่องนี้ไว้ ก็จะไม่เห็นหน้าต่อๆ ไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ChangeHistoryResourceType

ประเภทของทรัพยากรที่สามารถแสดงการเปลี่ยนแปลงจากประวัติการเปลี่ยนแปลง

Enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED ไม่ทราบหรือไม่ได้ระบุประเภททรัพยากร
ACCOUNT ทรัพยากรของบัญชี
PROPERTY ทรัพยากรพร็อพเพอร์ตี้
GOOGLE_SIGNALS_SETTINGS แหล่งข้อมูล GoogleSignalsSettings
CONVERSION_EVENT แหล่งข้อมูลเหตุการณ์ Conversion
MEASUREMENT_PROTOCOL_SECRET ทรัพยากร MeasurementProtocolSecret
CUSTOM_DIMENSION ทรัพยากร CustomDimension
CUSTOM_METRIC ทรัพยากร CustomMetric
DATA_RETENTION_SETTINGS แหล่งข้อมูลการตั้งค่าการเก็บรักษาข้อมูล
DATA_STREAM ทรัพยากร DataStream
ATTRIBUTION_SETTINGS แหล่งข้อมูล AttributionSettings
EXPANDED_DATA_SET ทรัพยากรชุดข้อมูลแบบขยาย
CHANNEL_GROUP ทรัพยากร ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS แหล่งข้อมูล EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS แหล่งข้อมูล DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA ทรัพยากร SKAdNetworkConversionValueSchema
AUDIENCE ทรัพยากรกลุ่มเป้าหมาย
EVENT_CREATE_RULE ทรัพยากร EventCreateRule
CALCULATED_METRIC ทรัพยากรเมตริกที่คำนวณแล้ว

ActionType

ประเภทของการดำเนินการที่อาจเปลี่ยนทรัพยากร

Enum
ACTION_TYPE_UNSPECIFIED ไม่ทราบประเภทการดำเนินการหรือไม่ได้ระบุ
CREATED มีการสร้างทรัพยากรในการเปลี่ยนแปลงนี้
UPDATED มีการอัปเดตแหล่งข้อมูลในการเปลี่ยนแปลงนี้
DELETED ทรัพยากรถูกลบในการเปลี่ยนแปลงนี้

ChangeHistoryEvent

ชุดการเปลี่ยนแปลงภายในบัญชี Google Analytics หรือพร็อพเพอร์ตี้ย่อยในบัญชีที่เกิดจากสาเหตุเดียวกัน สาเหตุที่พบบ่อยคือการอัปเดตใน UI ของ 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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
actorType

enum (ActorType)

ประเภทนักแสดงที่ทำการเปลี่ยนแปลงนี้
userActorEmail

string

อีเมลของบัญชี Google ที่ทำการเปลี่ยนแปลง ที่อยู่อีเมลนี้จะเป็นอีเมลที่ถูกต้องหากมีการตั้งค่าช่องนักแสดงเป็น USER หรือเว้นว่างไว้ บัญชี Google ที่ลบไปแล้วจะทำให้เกิดข้อผิดพลาด
changesFiltered

boolean

หากเป็นจริง รายการของการเปลี่ยนแปลงที่แสดงผลจะถูกกรองออกและไม่ได้แสดงการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นในเหตุการณ์นี้
changes[]

object (ChangeHistoryChange)

รายการการเปลี่ยนแปลงที่เกิดขึ้นในเหตุการณ์ประวัติการเปลี่ยนแปลงนี้ซึ่งตรงตามตัวกรองที่ระบุใน SearchChangeHistoryEventsRequest

ActorType

ตัวแปรประเภทต่างๆ ที่สามารถเปลี่ยนแปลงทรัพยากร Google Analytics ได้

Enum
ACTOR_TYPE_UNSPECIFIED ไม่ทราบหรือไม่ได้ระบุประเภทนักแสดง
USER การเปลี่ยนแปลงที่ผู้ใช้ระบุไว้ใน actorEmail
SYSTEM การเปลี่ยนแปลงที่ทำโดยระบบ Google Analytics
SUPPORT การเปลี่ยนแปลงที่เจ้าหน้าที่ทีมสนับสนุนของ Google Analytics ดำเนินการ

ChangeHistoryChange

คำอธิบายการเปลี่ยนแปลงของทรัพยากร 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)
  },
  "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)

ภาพรวมของทรัพยากรพร็อพเพอร์ตี้ในประวัติการเปลี่ยนแปลง
googleSignalsSettings

object (GoogleSignalsSettings)

ภาพรวมของทรัพยากร GoogleSignalsSettings ในประวัติการเปลี่ยนแปลง
conversionEvent

object (ConversionEvent)

ภาพรวมของทรัพยากร ConversionEvent ในประวัติการเปลี่ยนแปลง
measurementProtocolSecret

object (MeasurementProtocolSecret)

ภาพรวมของทรัพยากร MeasurementProtocolSecret ในประวัติการเปลี่ยนแปลง
customDimension

object (CustomDimension)

ภาพรวมของทรัพยากร CustomDimension ในประวัติการเปลี่ยนแปลง
customMetric

object (CustomMetric)

ภาพรวมของทรัพยากร CustomMetrics ในประวัติการเปลี่ยนแปลง
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)

ภาพรวมของทรัพยากรที่คำนวณแล้วในประวัติการเปลี่ยนแปลง