Thiết lập quyền truy cập API

Sau đây là cách thiết lập quyền truy cập vào Data Manager API bằng SDK hoặc REST.

Điều kiện tiên quyết

Trước khi có thể sử dụng Data API, hãy đảm bảo bạn có những thông tin sau:

  1. Một dự án trên Google Cloud.
  2. Tài khoản Google đáp ứng cả hai tiêu chí sau:
    1. Đã được cấp quyền truy cập vào Data Manager API sau khi bạn điền vào Biểu mẫu thể hiện sự quan tâm đến Data Manager API. Nếu có thể xem trang chi tiết sản phẩm API, tức là bạn có quyền truy cập.
    2. Có quyền serviceusage.services.enable đối với dự án Google Cloud của bạn hoặc có một vai trò bao gồm quyền đó. Ví dụ: roles/owner và roles/serviceusage.serviceUsageAdmin đều có quyền serviceusage.services.enable. Để kiểm tra quyền của bạn, hãy xem phần Xem quyền truy cập hiện tại.

Bật API

Nếu bạn chưa bật, hãy bật Data Manager API.

Nếu bạn không tìm thấy Data Manager API, hãy xác minh rằng Tài khoản Google của bạn đáp ứng các điều kiện tiên quyết.

Thiết lập chế độ xác thực

Chọn và thiết lập một phương thức xác thực. Bạn nên Thiết lập thông tin xác thực mặc định của ứng dụng để tự động tìm thông tin xác thực từ môi trường. API này không sử dụng khoá API.

Bạn phải có phạm vi https://www.googleapis.com/auth/datamanager cho mọi thông tin xác thực được dùng với Data Manager API. Để xem ví dụ về cách sử dụng phạm vi, hãy xem tài liệu về lệnh gcloud auth application-default login.

Để tìm hiểu thêm về quy trình xác thực và thông tin đăng nhập cho ứng dụng của bạn, hãy xem phần Các phương thức xác thực tại Google và Cách hoạt động của Thông tin xác thực mặc định của ứng dụng.

Thiết lập quyền truy cập vào tài khoản hoạt động

Cấp cho email liên kết với tài khoản người dùng hoặc tài khoản dịch vụ của bạn quyền truy cập vào Destination.

Thiết lập SDK cho ngôn ngữ lập trình của bạn

Trên máy cục bộ, hãy cài đặt SDK mà bạn chọn:

REST

  1. Cập nhật các phần giữ chỗ trong mẫu sau, chẳng hạn như OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID và AUDIENCE_ID, bằng các giá trị cho tài khoản và đích đến của bạn.
  2. Thay thế PROJECT_ID bằng mã nhận dạng Google Cloud của bạn.

  3. Sao chép mẫu vào dòng lệnh để gửi yêu cầu.

    Xoá thuộc tính linkedAccount của mục trong destinations nếu bạn không truy cập vào operationAccount bằng một đường liên kết đến sản phẩm đã thiết lập.

    #!/bin/bash

# Uses gcloud to get an access token.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
  --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. Tải và trích xuất google-cloud-ads-datamanager-v1-java.tar.gz.
  2. Chuyển đến thư mục google-cloud-ads-datamanager-v1-java.

  3. Chạy lệnh sau để tạo và phát hành thư viện vào kho lưu trữ Maven cục bộ để dùng với Maven hoặc Gradle.

    ./gradlew -Pversion=0.1.0 install

  4. Trong dự án Java, hãy khai báo một phần phụ thuộc vào thư viện 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. Không bắt buộc. Tải thư viện tiện ích và mã mẫu.

    1. Tải xuống và trích xuất data-manager-java.tar.gz.
    2. Chuyển đến thư mục data-manager-java.

    3. Đối với Maven hoặc Gradle, hãy chạy lệnh sau. Lệnh này sẽ tạo và xuất bản thư viện tiện ích vào kho lưu trữ Maven cục bộ.

      ./gradlew data-manager-util:install

    4. Trong dự án Java, hãy khai báo một phần phụ thuộc vào thư viện tiện ích.

      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. Để định dạng và mã hoá dữ liệu, hãy sử dụng các tiện ích UserDataFormatter và Encrypter trong dự án Java của bạn.

    6. Duyệt xem các mã mẫu trong thư mục con data-manager-samples. Để chạy một mẫu từ dòng lệnh, hãy sử dụng tác vụ run của Gradle.

      Ví dụ: lệnh sau đây chạy mẫu IngestAudienceMembers và in một câu lệnh về cách sử dụng:

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

      Để giúp bạn bắt đầu với một số dữ liệu mẫu, hãy sử dụng tệp tại data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Python

  1. Tải ads-datamanager-v1-py.tar.gz xuống.
  2. Chuyển đến thư mục chứa nội dung tải xuống.

  3. Chạy lệnh sau để tạo thư viện và cung cấp thư viện đó cho các dự án khác trong cùng môi trường Python:

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

  4. Trong dự án Python, hãy khai báo một phần phụ thuộc vào thư viện Data Manager API. Ví dụ: nếu sử dụng tệp requirements.txt trong dự án, hãy thêm dòng sau vào tệp:

    google-ads-data-manager=0.1.0

  5. Không bắt buộc. Tải thư viện tiện ích và mã mẫu.

    1. Tải xuống và trích xuất data-manager-python.tar.gz.
    2. Chuyển đến thư mục data-manager-python.

    3. Để cài đặt thư viện tiện ích trong môi trường Python, hãy chạy lệnh sau:

      pip install .

    4. Trong dự án Python, hãy khai báo một phần phụ thuộc vào thư viện tiện ích. Ví dụ: nếu bạn đang sử dụng tệp requirements.txt trong dự án, hãy thêm dòng sau vào tệp:

      google-ads-data-manager-util=0.1.0

    5. Để định dạng và mã hoá dữ liệu, hãy sử dụng các tiện ích Formatter và Encrypter trong dự án Python của bạn.

    6. Duyệt xem các mã mẫu trong thư mục con samples. Truyền đối số --help khi chạy một mẫu để in câu lệnh sử dụng với các tham số dự kiến.

      Để giúp bạn bắt đầu với một số dữ liệu mẫu, hãy sử dụng tệp tại samples/sampledata/audience_members_1.csv.

Node.js

  1. Tải và trích xuất ads-datamanager-v1-nodejs.tar.gz.
  2. Chuyển đến thư mục ads-datamanager-v1-nodejs.

  3. Chạy các lệnh sau để biên dịch và đóng gói thư viện vào một tệp .tgz để dùng với npm.

    npm install
npm pack

    Các lệnh này sẽ tạo một tệp lưu trữ có tên là google-cloud-datamanager-0.1.0.tgz.

  4. Trong dự án Node.js, hãy khai báo một phần phụ thuộc vào thư viện Data Manager API bằng cách thêm một mục nhập dependencies cho đường dẫn và tên tệp đầy đủ của tệp google-cloud-datamanager-0.1.0.tgz.

PHP

  1. Tải google-cloud-ads-datamanager-v1-php.tar.gz xuống và trích xuất.
  2. Chuyển đến thư mục google-cloud-ads-datamanager-v1-php.

  3. Chạy lệnh sau để giải quyết các phần phụ thuộc cho thư viện:

    composer update --prefer-dist

  4. Trong tệp composer.json của dự án PHP trên cùng một máy chủ lưu trữ, hãy khai báo một phần phụ thuộc vào thư viện Data Manager API bằng cách làm theo các bước sau:

    1. Thêm một phần repositories trỏ đến vị trí của thư mục google-cloud-ads-datamanager-v1-php.

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

    2. Khai báo một phần phụ thuộc trên thư viện Data Manager API.

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

  5. (Không bắt buộc) Tải thư viện tiện ích và mã mẫu.

    1. Tải xuống và trích xuất data-manager-php.tar.gz.
    2. Chuyển đến thư mục data-manager-php.

    3. Chạy lệnh sau để giải quyết các phần phụ thuộc cho thư viện:

      composer update --prefer-dist

    4. Trong tệp composer.json của dự án PHP trên cùng một máy chủ lưu trữ, hãy khai báo một phần phụ thuộc vào thư viện tiện ích bằng cách làm theo các bước sau:

      1. Thêm một mục trong phần repositories trỏ đến vị trí của thư mục data-manager-php.

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

      2. Khai báo một phần phụ thuộc vào thư viện tiện ích.

        "require": {
   "googleads/data-manager-util": "@dev"
}

      Để định dạng dữ liệu, hãy sử dụng tiện ích Formatter trong dự án PHP của bạn.

    5. Duyệt xem các mã mẫu trong thư mục con samples. Chạy các mẫu bằng cách thực hiện các bước sau:

      1. Chuyển đến thư mục samples.

      2. Đặt biến môi trường DATA_MANAGER_PHP_LIB thành đường dẫn nơi bạn đã trích xuất thư viện ứng dụng.

        export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"

      3. Chạy lệnh sau để giải quyết các phần phụ thuộc cho thư viện:

        composer update --prefer-dist

      4. Chạy các mẫu, truyền mọi đối số bắt buộc. Truyền đối số --help khi chạy một mẫu để in câu lệnh sử dụng với các tham số dự kiến.

      Để giúp bạn bắt đầu với một số dữ liệu mẫu, hãy sử dụng tệp tại samples/sampledata/audience_members_1.csv.