Method: audienceMembers.ingest

將 AudienceMember 資源清單上傳至提供的 Destination。

HTTP 要求

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

這個網址使用 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)

必要欄位。要傳送至指定目的地的使用者清單。單一要求最多可傳送 10000 個 AudienceMember 資源。
consent

object (Consent)

(選用步驟) 要求層級的同意聲明，適用於要求中的所有使用者。使用者層級同意聲明會覆寫要求層級同意聲明，且可在每個 AudienceMember 中指定。
validateOnly

boolean

(選用步驟) 僅供測試用途。如果為 true，系統會驗證要求，但不會執行。系統只會傳回錯誤，不會傳回結果。
encoding

enum (Encoding)

(選用步驟) 上傳 UserData 時必須提供這項資訊。使用者 ID 的編碼類型。如果是經過雜湊處理的使用者 ID，這就是雜湊字串的編碼類型。如果是加密的雜湊使用者 ID，這是外部加密字串的編碼類型，但不一定是內部雜湊字串的編碼類型，也就是說，內部雜湊字串的編碼方式可能與外部加密字串不同。如果上傳的不是 UserData，系統會忽略這個欄位。
encryptionInfo

object (EncryptionInfo)

(選用步驟) UserData 上傳內容的加密資訊。如果未設定，系統會假設上傳的識別資訊已雜湊處理，但未加密。如果上傳的不是 UserData，系統會忽略這個欄位。
termsOfService

object (TermsOfService)

(選用步驟) 使用者接受/拒絕的服務條款。

回應主體

IngestAudienceMembersRequest 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "requestId": string
}
欄位
requestId

string

系統自動產生的要求 ID。

授權範圍

需要下列 OAuth 範圍：

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

TermsOfService

使用者接受/拒絕的服務條款。

JSON 表示法 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
欄位
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

(選用步驟) 目標顧客比對服務條款：https://support.google.com/adspolicy/answer/6299717。您必須接受這項條款，才能將資料上傳至目標顧客比對使用者名單。

TermsOfServiceStatus

代表呼叫者接受或拒絕服務條款的決定。

列舉
TERMS_OF_SERVICE_STATUS_UNSPECIFIED 不指定。
ACCEPTED 狀態：表示來電者已選擇接受《服務條款》。
REJECTED 狀態：表示呼叫者已選擇拒絕服務條款。