Method: users.ingest

อัปโหลดรายชื่อผู้ใช้ไปยังปลายทางที่ระบุ audienceMembers.ingest (ซึ่งเพิ่มผู้ใช้ไปยังรายการกลุ่มเป้าหมายของผู้ลงโฆษณาที่เฉพาะเจาะจงเพื่อการกำหนดเป้าหมาย) จะแตกต่างจาก users.ingest ซึ่งจะนําเข้าข้อมูลการลิงก์ข้อมูลระบุตัวตนระดับบัญชี (เช่น ตัวระบุผู้ใช้ที่ลิงก์กับรหัสอุปกรณ์เคลื่อนที่) โดยไม่ขึ้นอยู่กับกลุ่มเป้าหมายที่เฉพาะเจาะจง

ฟีเจอร์นี้พร้อมใช้งานสำหรับบัญชีในรายการที่อนุญาตเท่านั้น

คำขอ HTTP

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

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

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

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

การแสดง JSON
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
ช่อง
destinations[]

object (Destination)

ต้องระบุ รายการปลายทางการนำเข้าที่เป็นไปได้

users[]

object (User)

ต้องระบุ รายชื่อผู้ใช้ที่จะส่งผ่านข้อมูล

encryptionInfo

object (EncryptionInfo)

ไม่บังคับ ข้อมูลการเข้ารหัสเกี่ยวกับคีย์การเข้ารหัสที่ใช้เพื่อเข้ารหัสข้อมูล

validateOnly

boolean

ไม่บังคับ หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ

encoding

enum (Encoding)

ต้องระบุ ประเภทการเข้ารหัสของตัวระบุผู้ใช้ สําหรับตัวระบุผู้ใช้ที่เข้ารหัส การดำเนินการนี้จะมีผลกับการเข้ารหัสชั้นนอกเท่านั้น

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

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

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

การแสดง JSON
{
  "requestId": string
}
ช่อง
requestId

string

รหัสคำขอที่สร้างขึ้นของคำขอส่งผ่านข้อมูล

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

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

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

ผู้ใช้

แสดงถึงผู้ใช้รายเดียว ซึ่งมีตัวระบุ เช่น PII และรหัสอุปกรณ์เคลื่อนที่ ซึ่งทั้งหมดอ้างอิงถึงผู้ใช้รายเดียวกัน

การแสดง JSON
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
ช่อง
userData

object (UserData)

ต้องระบุ ข้อมูลที่ได้จากผู้ใช้หลายรายการซึ่งใช้เป็นวิธีการระบุตัวตนของผู้ใช้

mobileData

object (MobileData)

ต้องระบุ สตริงรหัสอุปกรณ์เคลื่อนที่หลายรายการเพื่อแสดงผู้ใช้คนเดียว