Method: audienceMembers.ingest

Tải danh sách AudienceMember tài nguyên lên Destination đã cung cấp.

Yêu cầu HTTP

POST https://datamanager.googleapis.com/v1/audienceMembers: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)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Trường
destinations[]

object (Destination)

Bắt buộc. Danh sách đích đến để chuyển các thành viên trong đối tượng đến.
audienceMembers[]

object (AudienceMember)

Bắt buộc. Danh sách người dùng cần gửi đến đích đến đã chỉ định. Bạn có thể gửi tối đa 10.000 AudienceMember tài nguyên trong một yêu cầu.
consent

object (Consent)

Không bắt buộc. Sự đồng ý ở cấp yêu cầu sẽ áp dụng cho tất cả người dùng trong yêu cầu. Sự đồng ý ở cấp người dùng sẽ ghi đè sự đồng ý ở cấp yêu cầu và có thể được chỉ định trong mỗi AudienceMember.
validateOnly

boolean

Không bắt buộc. Chỉ dùng cho mục đích kiểm thử. Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.
encoding

enum (Encoding)

Không bắt buộc. Bắt buộc đối với tệp tải lên UserData. Loại mã hoá của giá trị nhận dạng người dùng. Đối với giá trị nhận dạng người dùng đã băm, đây là loại mã hoá của chuỗi đã băm. Đối với giá trị nhận dạng người dùng được băm đã mã hoá, đây là loại mã hoá của chuỗi được mã hoá bên ngoài, nhưng không nhất thiết phải là chuỗi được băm bên trong. Tức là chuỗi được băm bên trong có thể được mã hoá theo cách khác với chuỗi được mã hoá bên ngoài. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.
encryptionInfo

object (EncryptionInfo)

Không bắt buộc. Thông tin mã hoá cho nội dung tải lên UserData. Nếu bạn không đặt, thì hệ thống sẽ giả định rằng thông tin nhận dạng được tải lên đã được băm nhưng chưa được mã hoá. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.
termsOfService

object (TermsOfService)

Không bắt buộc. Điều khoản dịch vụ mà người dùng đã chấp nhận/từ chối.

Nội dung phản hồi

Câu trả lời của IngestAudienceMembersRequest.

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ã nhận dạng được tạo tự động của yêu cầu.

Phạm vi uỷ quyền

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

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

TermsOfService

Điều khoản dịch vụ mà người dùng đã chấp nhận/từ chối.

Biểu diễn dưới dạng JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Trường
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Không bắt buộc. Điều khoản dịch vụ về tính năng So khớp khách hàng: https://support.google.com/adspolicy/answer/6299717. Bạn phải chấp nhận điều này khi tiếp nhận UserData hoặc MobileData. Bạn không bắt buộc phải điền trường này cho Danh sách người dùng so khớp đối tác.

TermsOfServiceStatus

Biểu thị quyết định của người gọi về việc chấp nhận hoặc từ chối điều khoản dịch vụ.

Enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Chưa chỉ định.
ACCEPTED Trạng thái cho biết người gọi đã chọn chấp nhận điều khoản dịch vụ.
REJECTED Trạng thái cho biết người gọi đã chọn từ chối điều khoản dịch vụ.