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
}
ช่อง
requestId

string

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

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

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

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

TermsOfService

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

การแสดง JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
ช่อง
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

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

TermsOfServiceStatus

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

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