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)

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

string

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

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 (ค่าที่สูงกว่าจะถูกบังคับให้เป็นค่าสูงสุด)

โปรดทราบว่าบริการอาจแสดงผลหน้าเว็บที่มีจำนวนรายการน้อยกว่าค่าที่ระบุ (อาจเป็น 0 ด้วย) และอาจยังมีหน้าเว็บเพิ่มเติม หากต้องการรายการในจำนวนที่เฉพาะเจาะจง คุณจะต้องขอหน้าเว็บเพิ่มเติมโดยใช้ pageToken ต่อไปจนกว่าจะได้จำนวนที่ต้องการ
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 แหล่งข้อมูล 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 เสมอ และใช้ตัวเลขเศษส่วน 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.
}
ช่อง

ฟิลด์ Union resource

resource ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
account

object (Account)

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

object (Property)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (DataRetentionSettings)

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

object (DataStream)

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