Method: accounts.searchChangeHistoryEvents

ค้นหาการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นกับบัญชีหรือระดับย่อยในบัญชีตามชุดตัวกรองที่ระบุ

คำขอ HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{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
DATA_RETENTION_SETTINGS แหล่งข้อมูลการตั้งค่าการเก็บรักษาข้อมูล
DATA_STREAM ทรัพยากร DataStream
ATTRIBUTION_SETTINGS แหล่งข้อมูล AttributionSettings

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)
  },
  "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)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (DataRetentionSettings)

ภาพรวมของทรัพยากรการตั้งค่าการเก็บรักษาข้อมูลในประวัติการเปลี่ยนแปลง
dataStream

object (DataStream)

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