設定 API 存取權

以下說明如何使用 SDK 或 REST 設定 Data Manager API 存取權。

設定 Google Cloud 指令列介面

  1. 安裝並初始化 Google Cloud 指令列介面。

  2. 為確保 gcloud 元件為最新版本，請執行下列指令。

    gcloud components update

  3. (選用) 使用 gcloud config set 指令設定預設專案和區域。

設定驗證方法

您可以使用使用者帳戶和服務帳戶進行驗證：

  • 使用者帳戶：代表直接與 Google API 和服務互動的使用者。
  • 服務帳戶：代表應用程式，而非使用者。讓應用程式管理驗證和授權。例如，如果應用程式需要存取 Google Cloud 資源。

整合作業可以使用應用程式預設憑證 (ADC)，自動在環境中尋找憑證。您不需要變更用戶端程式碼來進行驗證。

選擇「使用者帳戶」或「服務帳戶」來設定 ADC：

如要進一步瞭解應用程式的驗證和憑證，請參閱「Google 的驗證方式」和「設定應用程式預設憑證」。

設定營運帳戶存取權

授予與使用者或服務帳戶相關聯的電子郵件存取權，以便存取 Destination。

根據程式設計語言設定 SDK

在本機上安裝所選 SDK：

REST

  1. 請將下列範例中的預留位置 (例如 OPERATING_ACCOUNT_PRODUCT、OPERATING_ACCOUNT_ID 和 AUDIENCE_ID) 更新為帳戶和目的地的值。
  2. 將 PROJECT_ID 替換為 Google Cloud 的 ID。

  3. 將範例複製到指令列，即可傳送要求。

    如果您未使用已建立的產品連結存取 operationAccount，請移除 destinations 中項目的 linkedAccount 屬性。

    #!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

Java

  1. 下載並解壓縮 google-cloud-ads-datamanager-v1-java.tar.gz。
  2. 前往 google-cloud-ads-datamanager-v1-java 目錄。

  3. 執行下列指令，將程式庫建構並發布至本機 Maven 存放區，以便與 Maven 或 Gradle 搭配使用。

    ./gradlew -Pversion=0.1.0 install

  4. 在 Java 專案中，宣告對 Data Manager API 程式庫的依附元件。

    Gradle：

    implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.0'

    Maven：

    <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.0</version>
</dependency>

  5. (選用) 取得公用程式庫和程式碼範例。

    1. 下載並解壓縮 data-manager-java.tar.gz。
    2. 前往 data-manager-java 目錄。

    3. 如為 Maven 或 Gradle，請執行下列指令。這個指令會建構公用程式庫，並將其發布至您的本機 Maven 存放區。

      ./gradlew data-manager-util:install

    4. 在 Java 專案中，宣告公用程式庫的依附元件。

      Gradle：

      implementation 'com.google.api-ads:data-manager-util:0.1.0'

      Maven：

      <dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>

    5. 如要格式化及加密資料，請在 Java 專案中使用 UserDataFormatter 和 Encrypter 公用程式。

    6. 瀏覽 data-manager-samples 子目錄中的程式碼範例。如要透過指令列執行範例，請使用 Gradle run 工作。

      舉例來說，下列指令會執行 IngestAudienceMembers 範例，並列印用法陳述式：

      ./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'

      如要開始使用一些範例資料，請使用 data-manager-samples/src/main/resources/sampledata/audience_members_1.csv 中的檔案。

Python

  1. 下載 ads-datamanager-v1-py.tar.gz。
  2. 前往下載檔案的目錄。

  3. 執行下列指令，即可建構程式庫，並讓同一個 Python 環境中的其他專案使用該程式庫：

    pip install ./ads-datamanager-v1-py.tar.gz

  4. 在 Python 專案中，宣告對 Data Manager API 程式庫的依附元件。舉例來說，如果在專案中使用 requirements.txt 檔案，請在檔案中新增下列程式碼：

    google-ads-data-manager=0.1.0

  5. (選用) 取得公用程式庫和程式碼範例。

    1. 下載並解壓縮 data-manager-python.tar.gz。
    2. 前往 data-manager-python 目錄。

    3. 如要在 Python 環境中安裝公用程式庫，請執行下列指令：

      pip install .

    4. 在 Python 專案中，宣告公用程式程式庫的依附元件。舉例來說，如果在專案中使用 requirements.txt 檔案，請在檔案中加入下列程式碼行：

      google-ads-data-manager-util=0.1.0

    5. 如要格式化及加密資料，請在 Python 專案中使用 Formatter 和 Encrypter 公用程式。

    6. 瀏覽 samples 子目錄中的程式碼範例。執行範例時傳遞 --help 引數，以便列印含有預期參數的用法陳述式。

      如要開始使用一些範例資料，請使用 samples/sampledata/audience_members_1.csv 中的檔案。

Node.js

  1. 下載並解壓縮 ads-datamanager-v1-nodejs.tar.gz。
  2. 前往 ads-datamanager-v1-nodejs 目錄。

  3. 執行下列指令，將程式庫編譯並封裝至 .tgz 檔案，以便與 npm 搭配使用。

    npm install
npm pack

    這些指令會產生名為 google-cloud-datamanager-0.1.0.tgz 的封存檔。

  4. 在 Node.js 專案中，針對 google-cloud-datamanager-0.1.0.tgz 檔案的完整路徑和檔案名稱，新增 dependencies 項目，宣告 Data Manager API 程式庫的依附元件。

PHP

  1. 下載並解壓縮 google-cloud-ads-datamanager-v1-php.tar.gz。
  2. 前往 google-cloud-ads-datamanager-v1-php 目錄。

  3. 執行下列指令，解析程式庫的依附元件：

    composer update --prefer-dist

  4. 在相同主機上 PHP 專案的 composer.json 檔案中，使用下列步驟宣告 Data Manager API 程式庫的依附元件：

    a. 新增 repositories 區段，指向 google-cloud-ads-datamanager-v1-php 目錄的位置。

     "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]

    b. 宣告對 Data Manager API 程式庫的依附元件。

     "require": {
    "googleads/data-manager": "^0.1.0"
 }