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

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

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

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

Các bước cài đặt

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

REST

Cập nhật các phần giữ chỗ trong mẫu sau đây, 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 của Google Cloud.

Sao chép mẫu vào dòng lệnh để gửi yêu cầu. Chỉ sử dụng mẫu Đối tác dữ liệu nếu bạn đang truy cập vào tài khoản điều hành thông qua một đường liên kết đối tác. Nếu không, hãy sử dụng mẫu Nhà quảng cáo.

Nhà quảng cáo

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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

Đối tác dữ liệu

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "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

.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 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: Tải thư viện tiện ích và mã mẫu.

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

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

Trong dự án .NET, hãy khai báo 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.
Duyệt qua các mã mẫu trong thư mục con samples hoặc trên GitHub.

Chuyển sang 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 có 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 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: Tải thư viện tiện ích và mã mẫu.

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

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

Chuyển đến thư mục data-manager-java.
Tạo và phát hành 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 phần phụ thuộc trên 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.
Duyệt qua 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 câu lệnh 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 phần phụ thuộc vào @google-ads/datamanager thư viện ứng dụng 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 repository.

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
```
Chuyển sang 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 thành tệp .tgz để sử dụng với npm.
```
npm pack
```
Lệnh này tạo một tệp lưu trữ có tên là google-ads-datamanager-util-0.2.0.tgz. Hãy ghi lại vị trí tệp để bạn có thể sử dụng tệp đó trong các bước tiếp theo.
Trong dự án Node.js, hãy khai báo phần phụ thuộc trên thư viện tiện ích Data Manager API bằng cách thêm mục dependencies cho đường dẫn đầy đủ và tên tệp 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 qua các mã mẫu trong thư mục con samples hoặc trên GitHub. Chạy các mẫu theo 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 có các tham số dự kiến.
  
  Ví dụ: lệnh sau đây chạy mẫu ingest_audience_members và in câu lệnh 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 phần phụ thuộc vào googleads/data-manager thư viện ứng dụng 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 repository.

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

Chuyển đến thư mục data-manager-php.
Chạy lệnh sau để phân giải 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ủ, hãy khai báo phần phụ thuộc trên thư viện tiện ích 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 phần phụ thuộc trên 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.
Duyệt qua các mã mẫu trong thư mục con samples hoặc trên GitHub. Chạy các mẫu theo các bước sau:
1. Chuyển đến thư mục samples.
2. Chạy lệnh sau để phân giải 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 có 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 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 repository.

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 phần phụ thuộc trên thư viện tiện ích. 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-datamanager-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.
Duyệt qua 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 có 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 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ề cách gửi dữ liệu đối tượng.
Tìm hiểu thêm về cách gửi sự kiện.
Duyệt qua tài liệu tham khảo 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ác bước cài đặt

REST

Nhà quảng cáo

Đối tác dữ liệu

.NET

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.

Java

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.

Node.js

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.

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