Method: accounts.searchChangeHistoryEvents

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

แสดงเฉพาะชุดย่อยของการเปลี่ยนแปลงที่ API รองรับ UI อาจแสดงการเปลี่ยนแปลงเพิ่มเติม

คำขอ 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

ไม่บังคับ ชื่อทรัพยากรสําหรับพร็อพเพอร์ตี้ย่อย หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่ทำกับพร็อพเพอร์ตี้นี้หรือทรัพยากรย่อยเท่านั้น รูปแบบ: properties/{propertyId}

ตัวอย่าง: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

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

enum (ActionType)

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

string

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

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตที่ไม่ใช่ "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
latestChangeTime

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตที่ไม่ใช่ "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
pageSize

integer

ไม่บังคับ จํานวนรายการ ChangeHistoryEvent สูงสุดที่จะแสดง หากไม่ระบุ ระบบจะแสดงผลรายการสูงสุด 50 รายการ ค่าสูงสุดคือ 200 (ระบบจะบังคับค่าที่สูงกว่าให้เท่ากับค่าสูงสุด)

โปรดทราบว่าบริการอาจแสดงผลหน้าเว็บที่มีรายการน้อยกว่าที่ระบุค่านี้ (อาจไม่มีเลย) และอาจมีหน้าเว็บเพิ่มเติม หากต้องการรายการจำนวนหนึ่งๆ คุณจะต้องขอหน้าเพิ่มเติมโดยใช้ pageToken ต่อจนกว่าจะได้จำนวนที่ต้องการ
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
CUSTOM_DIMENSION ทรัพยากร CustomDimension
CUSTOM_METRIC ทรัพยากร CustomMetric
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)

เวลาที่ทําการเปลี่ยนแปลง

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตที่ไม่ใช่ "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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 ในประวัติการเปลี่ยนแปลง