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

ไม่บังคับ ชื่อทรัพยากรสำหรับพร็อพเพอร์ตี้ย่อย หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่เกิดขึ้นกับพร็อพเพอร์ตี้นี้หรือทรัพยากรย่อยของพร็อพเพอร์ตี้นี้เท่านั้น รูปแบบ: พร็อพเพอร์ตี้/{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 ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ

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

ข้อความตอบกลับสำหรับ 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 ทรัพยากร DataStorageSettings
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 ในประวัติการเปลี่ยนแปลง