Method: customers.uploadUserData

อัปโหลดข้อมูลผู้ใช้ที่ระบุ

รายการข้อผิดพลาดที่มีการเชื่อมโยง: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่จะอัปเดตข้อมูลผู้ใช้

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
ช่อง
operations[]

object (UserDataOperation)

ต้องระบุ รายการการดำเนินการที่ต้องทำ
ฟิลด์การรวม metadata ข้อมูลเมตาของคำขอ metadata ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

ข้อมูลเมตาสำหรับการอัปเดตข้อมูลในรายชื่อผู้ใช้การจับคู่ข้อมูลลูกค้า

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

ข้อความตอบกลับสำหรับ UserDataService.UploadUserData การอัปโหลดที่ดำเนินการผ่านบริการนี้จะไม่ปรากฏในส่วน "สมาชิกกลุ่ม" สำหรับรายการการจับคู่ข้อมูลลูกค้าใน UI ของ Google Ads

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

การแสดง JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
ช่อง
uploadDateTime

string

วันที่และเวลาที่ API ได้รับคำขอ โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00"
receivedOperationsCount

integer

จำนวนการดำเนินการอัปโหลดข้อมูลที่ API ได้รับ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

UserDataOperation

การดำเนินการที่จะเกิดขึ้นกับ UploadUserDataRequest

การแสดง JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
ช่อง
ฟิลด์การรวม operation การดำเนินการที่จะเกิดขึ้นกับ UploadUserDataRequest operation ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
create

object (UserData)

รายการข้อมูลผู้ใช้ที่จะต่อท้ายรายชื่อผู้ใช้
remove

object (UserData)

รายการข้อมูลผู้ใช้ที่จะนำออกจากรายชื่อผู้ใช้