Method: accounts.searchChangeHistoryEvents

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
account

string

ต้องระบุ ทรัพยากรบัญชีที่จะแสดงผลทรัพยากรประวัติการเปลี่ยนแปลง รูปแบบ: บัญชี/{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)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงสำหรับทรัพยากรที่ตรงกับประเภทเหล่านี้อย่างน้อย 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 ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ

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

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

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

การแสดง 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 ทรัพยากร ConversionEvent
MEASUREMENT_PROTOCOL_SECRET ทรัพยากร MeasurementProtocolSecret
DATA_RETENTION_SETTINGS ทรัพยากร DataRetentionSettings
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 ในประวัติการเปลี่ยนแปลง