Method: users.ingest

將使用者清單上傳至指定目的地。與 audienceMembers.ingest (將使用者加入特定廣告主目標對象名單以指定目標) 不同，users.ingest 會擷取帳戶層級的身分連結資料 (例如連結至行動 ID 的使用者 ID)，與特定目標對象區隔無關。

這項功能僅適用於已加入許可清單的帳戶。

HTTP 要求

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

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

必填。使用者 ID 的編碼類型。如果是加密的使用者 ID，這項限制只適用於外部編碼。

回應主體

IngestUsersRequest 的回應。

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

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

string

擷取要求的產生要求 ID。

授權範圍

需要下列 OAuth 範圍：

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

使用者

代表單一使用者，包含個人識別資訊和行動裝置 ID 等 ID，這些 ID 都指向同一位使用者。

JSON 表示法 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
欄位
userData

object (UserData)

必填。多項使用者提供的資料，用來識別使用者。
mobileData

object (MobileData)

必填。多個行動裝置 ID 字串，代表單一使用者。