Cài đặt thư viện ứng dụng

Sau đây là cách cài đặt và định cấu hình một thư viện ứng dụng hoặc REST.

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

Trước khi cài đặt một thư viện ứng dụng, hãy hoàn tất các bước trong phần Thiết lập quyền truy cập API, bao gồm cả việc định cấu hình Thông tin đăng nhập mặc định của ứng dụng (ADC).

Cài đặt thư viện

Trên máy cục bộ, hãy cài đặt thư viện ứng dụng mà bạn chọn:

REST

Chọn loại quy trình thiết lập mà bạn muốn thực hiện:

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.
Thay thế PROJECT_ID bằng mã nhận dạng Google Cloud của bạn.

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

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account, the command that specifies
# --scopes fails. This sample falls back to the command without the
# --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
  gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If you
# get scope-related errors when you send the request in the next step,
# verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# 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": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_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

.NET

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng.NET để thêm một phần phụ thuộc vào thư viện ứng dụng trong dự án của bạn.

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

Sao chép kho lưu trữ GitHub.

git clone https://github.com/googleads/data-manager-dotnet.git

Trong dự án .NET, hãy khai báo một phần phụ thuộc ProjectReference trên thư viện tiện ích. Thay thế PATH_TO_UTILITY_LIBRARY bằng vị trí mà bạn đã sao chép kho lưu trữ data-manager-dotnet.
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
Để định dạng dữ liệu, hãy sử dụng tiện ích Formatter trong dự án .NET của bạn.
Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub.

Thay đổi thành thư mục samples và sử dụng dotnet run để lấy danh sách các mẫu có sẵn.
```
dotnet run
```
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.
```
dotnet run -- ingest-audience-members --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 samples/sampledata/audience_members_1.csv.

Java

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng Java để thêm một phần phụ thuộc vào thư viện ứng dụng trong dự án của bạn.

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

Sao chép kho lưu trữ GitHub.

git clone https://github.com/googleads/data-manager-java.git

Chuyển đến thư mục data-manager-java.
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
```

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.2.0'

Maven:

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

Để đị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.
Duyệt xem các mã mẫu trong thư mục con data-manager-samples hoặc trên GitHub. Để 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.

Node.js

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng Node.js để thêm một phần phụ thuộc vào thư viện ứng dụng @google-ads/datamanager trong dự án của bạn.

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

Sao chép kho lưu trữ GitHub.

git clone https://github.com/googleads/data-manager-node.git

Chuyển đến thư mục data-manager-node.
Chạy lệnh sau để cài đặt các phần phụ thuộc.
```
npm install
```
Thay đổi thành thư mục util.
```
cd util
```
Chạy lệnh sau để biên dịch và đóng gói thư viện tiện ích vào một tệp .tgz để dùng với npm.
```
npm pack
```
Lệnh này sẽ tạo một kho lưu trữ có tên là google-ads-datamanager-util-0.2.0.tgz. Ghi lại vị trí của tệp để bạn có thể sử dụng trong các bước tiếp theo.
Trong dự án Node.js, hãy khai báo một phần phụ thuộc vào thư viện tiện ích 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-ads-datamanager-util-0.2.0.tgz.
```
{
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}
```
Để định dạng dữ liệu, hãy sử dụng tiện ích UserDataFormatter trong dự án Node.js.
Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub. 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 data-manager-node.
2. 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 bằng các tham số dự kiến.
  
  Ví dụ: lệnh sau đây chạy mẫu ingest_audience_members và in một câu lệnh về cách sử dụng:
```
npm run ingest-audience-members -w samples -- --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 samples/sampledata/audience_members_1.csv.

PHP

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng PHP để thêm một phần phụ thuộc vào thư viện ứng dụng googleads/data-manager trong dự án của bạn.

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

Sao chép kho lưu trữ GitHub.

git clone https://github.com/googleads/data-manager-php.git

Chuyển đến thư mục data-manager-php.
Chạy lệnh sau để giải quyết các phần phụ thuộc cho thư viện:
```
composer update --prefer-dist
```
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.
Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub. Chạy các mẫu bằng cách làm theo các bước sau:
1. Chuyển đến thư mục samples.
2. Chạy lệnh sau để giải quyết các phần phụ thuộc cho thư viện:
```
composer update --prefer-dist
```
3. 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 bằng 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.

Python

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng Python để thêm một phần phụ thuộc vào thư viện ứng dụng google-ads-datamanager trong dự án của bạn.

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

Sao chép kho lưu trữ GitHub.

git clone https://github.com/googleads/data-manager-python.git

Chuyển đến thư mục data-manager-python.
Để cài đặt thư viện tiện ích trong môi trường Python, hãy chạy lệnh sau:
```
pip install .
```
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.2.0
```
Để đị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.
Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub. Để chạy các mẫu, hãy cài đặt các phần phụ thuộc cần thiết:
```
pip install .[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.

Ruby

Cài đặt thư viện ứng dụng

Làm theo hướng dẫn trong hướng dẫn cài đặt thư viện ứng dụng Ruby để thêm một phần phụ thuộc vào thư viện ứng dụng trong dự án của bạn.

Các bước tiếp theo

Tìm hiểu thêm về gửi dữ liệu về đối tượng.
Tìm hiểu thêm về cách gửi sự kiện.
Duyệt xem tài liệu tham khảo về REST hoặc RPC.

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

Cài đặt thư viện ứng dụng Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Cài đặt thư viện

REST

.NET

Cài đặt thư viện ứng dụng

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

Java

Cài đặt thư viện ứng dụng

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

Node.js

Cài đặt thư viện ứng dụng

Không bắt buộc: Nhận thư viện tiện ích và mã mẫu.

PHP

Cài đặt thư viện ứng dụng

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

Python

Cài đặt thư viện ứng dụng

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

Ruby

Cài đặt thư viện ứng dụng

Các bước tiếp theo

Cài đặt thư viện ứng dụng