Method: audienceMembers.ingest

อัปโหลดรายการแหล่งข้อมูล AudienceMember ไปยัง Destination ที่ระบุ

คำขอ HTTP

POST https://datamanager.googleapis.com/v1/audienceMembers:ingest

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

เนื้อความของคำขอ

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

การแสดง JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
ช่อง
destinations[]

object (Destination)

ต้องระบุ รายการปลายทางที่จะส่งสมาชิกกลุ่มเป้าหมายไป
audienceMembers[]

object (AudienceMember)

ต้องระบุ รายการผู้ใช้ที่จะส่งไปยังปลายทางที่ระบุ ส่งแหล่งข้อมูล AudienceMember ได้สูงสุด 10,000 รายการในคำขอเดียว
consent

object (Consent)

ไม่บังคับ ความยินยอมระดับคำขอที่จะใช้กับผู้ใช้ทั้งหมดในคำขอ ความยินยอมระดับผู้ใช้จะลบล้างความยินยอมระดับคำขอ และระบุได้ใน AudienceMember แต่ละรายการ
validateOnly

boolean

ไม่บังคับ สำหรับวัตถุประสงค์ในการทดสอบ หากเป็น true ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
encoding

enum (Encoding)

ไม่บังคับ ต้องระบุสำหรับการอัปโหลด UserData ประเภทการเข้ารหัสของตัวระบุผู้ใช้ สำหรับตัวระบุผู้ใช้ที่แฮช นี่คือประเภทการเข้ารหัสของสตริงที่แฮช สำหรับตัวระบุผู้ใช้ที่แฮชซึ่งเข้ารหัส นี่คือประเภทการเข้ารหัสของสตริงที่เข้ารหัสภายนอก แต่ไม่จำเป็นต้องเป็นสตริงที่แฮชภายใน ซึ่งหมายความว่าสตริงที่แฮชภายในอาจเข้ารหัสด้วยวิธีอื่นที่ไม่ใช่สตริงที่เข้ารหัสภายนอก สำหรับการอัปโหลดที่ไม่ใช่ UserData ระบบจะละเว้นช่องนี้
encryptionInfo

object (EncryptionInfo)

ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลด UserData หากไม่ได้ตั้งค่า ระบบจะถือว่าข้อมูลระบุตัวบุคคลที่อัปโหลดนั้นแฮชแล้วแต่ไม่ได้เข้ารหัส สำหรับการอัปโหลดที่ไม่ใช่ UserData ระบบจะละเว้นช่องนี้
termsOfService

object (TermsOfService)

ไม่บังคับ ข้อกำหนดในการให้บริการที่ผู้ใช้ยอมรับ/ปฏิเสธ

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

การตอบกลับจาก IngestAudienceMembersRequest

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

การแสดง JSON 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
ช่อง
requestId

string

รหัสที่สร้างขึ้นอัตโนมัติของคำขอ
fieldWarnings[]

object (FieldWarning)

คำเตือนระดับแถวโดยละเอียดพร้อมเส้นทางของช่อง

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

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

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

TermsOfService

ข้อกำหนดในการให้บริการที่ผู้ใช้ยอมรับ/ปฏิเสธ

การแสดง JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
ฟิลด์
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

ไม่บังคับ ข้อกำหนดในการให้บริการของการจับคู่ข้อมูลลูกค้า: https://support.google.com/adspolicy/answer/6299717 ต้องยอมรับข้อกำหนดนี้เมื่อนำเข้า UserData หรือ MobileData ช่องนี้ไม่จำเป็นสำหรับรายชื่อผู้ใช้ Partner Match

TermsOfServiceStatus

แสดงถึงการตัดสินใจของผู้เรียกที่จะยอมรับหรือปฏิเสธข้อกำหนดในการให้บริการ

Enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED ไม่ได้ระบุ
ACCEPTED สถานะที่ระบุว่าผู้เรียกเลือกที่จะยอมรับข้อกำหนดในการให้บริการ
REJECTED สถานะที่ระบุว่าผู้เรียกเลือกที่จะปฏิเสธข้อกำหนดในการให้บริการ