Method: users.ingest

Tải danh sách người dùng lên các đích đến được cung cấp. Không giống như audienceMembers.ingest (thêm người dùng vào danh sách đối tượng cụ thể của nhà quảng cáo để nhắm mục tiêu), users.ingest tiếp nhận dữ liệu liên kết danh tính ở cấp tài khoản (ví dụ: mã nhận dạng người dùng được liên kết với mã nhận dạng thiết bị di động) độc lập với các phân khúc đối tượng cụ thể.

Tính năng này chỉ dành cho những tài khoản có trong danh sách cho phép.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Trường
destinations[]

object (Destination)

Bắt buộc. Danh sách các đích đến có thể tiếp nhận.

users[]

object (User)

Bắt buộc. Danh sách người dùng cần nhập.

encryptionInfo

object (EncryptionInfo)

Không bắt buộc. Thông tin mã hoá về các khoá mã hoá dùng để mã hoá dữ liệu.

validateOnly

boolean

Không bắt buộc. Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi.

encoding

enum (Encoding)

Bắt buộc. Loại mã hoá của giá trị nhận dạng người dùng. Đối với mã nhận dạng người dùng được mã hoá, điều này chỉ áp dụng cho quá trình mã hoá bên ngoài.

Nội dung phản hồi

Phản hồi từ IngestUsersRequest.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "requestId": string
}
Trường
requestId

string

Mã yêu cầu được tạo của Yêu cầu nhập.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Người dùng

Đại diện cho một người dùng duy nhất, chứa các giá trị nhận dạng như thông tin nhận dạng cá nhân (PII) và mã nhận dạng thiết bị di động, tất cả đều đề cập đến cùng một người dùng.

Biểu diễn dưới dạng JSON
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Trường
userData

object (UserData)

Bắt buộc. Nhiều phần dữ liệu do người dùng cung cấp, được dùng làm phương tiện xác định người dùng.

mobileData

object (MobileData)

Bắt buộc. Nhiều chuỗi mã nhận dạng thiết bị di động để biểu thị một người dùng duy nhất.