Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 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 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 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 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 đường liên kết của đố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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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: Cài đặt thư viện tiện ích

Ngoài thư viện ứng dụng, bạn có thể cài đặt thư viện tiện ích để hỗ trợ các tác vụ phổ biến như định dạng dữ liệu để nhập.

Trong dự án .NET, hãy khai báo phần phụ thuộc vào thư viện tiện ích Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Để định dạng dữ liệu, hãy sử dụng tiện ích UserDataFormatter trong dự án .NET của bạn.

Duyệt xem mã mẫu

Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub.

Cách chạy mẫu:

Sao chép kho lưu trữ GitHub tại thẻ v0.4.0:

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

Chuyển đến thư mục data-manager-dotnet.
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ẫu để in câu lệnh sử dụng có các tham số dự kiến.
```
dotnet run -- ingest-audience-members --help
```

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

Go

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

go get cloud.google.com/go/datamanager/apiv1@latest

Làm theo hướng dẫn trong Hướng dẫn về thư viện ứng dụng Go để biết thêm thông tin.

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: Cài đặt thư viện tiện ích

Ngoài thư viện ứng dụng, bạn có thể cài đặt thư viện tiện ích để hỗ trợ các thao tác phổ biến như định dạng và mã hoá dữ liệu để nhập.

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

Gradle:

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

Maven:

<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.4.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 mã mẫu

Duyệt xem các mã mẫu trong thư mục con data-manager-samples hoặc trên GitHub.

Cách chạy mẫu:

Sao chép kho lưu trữ GitHub tại thẻ v0.4.0:

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

Chuyển đến thư mục data-manager-java.
Chạy các mẫu từ dòng lệnh bằng cách sử dụng tác vụ Gradle run, 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 IngestAudienceMembers và in ra một câu lệnh sử dụng:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

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

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 thư viện ứng dụng @google-ads/datamanager trong dự án của bạn.

Không bắt buộc: Cài đặt thư viện tiện ích

Ngoài thư viện ứng dụng, bạn có thể cài đặt thư viện tiện ích để hỗ trợ các tác vụ phổ biến như định dạng dữ liệu để nhập.

Trong dự án Node.js, hãy khai báo phần phụ thuộc vào thư viện tiện ích @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Để định dạng dữ liệu, hãy sử dụng tiện ích UserDataFormatter trong dự án Node.js của bạn.

Duyệt xem mã mẫu

Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub.

Cách chạy mẫu:

Sao chép kho lưu trữ GitHub tại thẻ v0.4.1:

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

Chuyển đến thư mục data-manager-node.
Cài đặt các phần phụ thuộc để chạy mẫu:
```
npm install
```
Chạy mẫu, truyền mọi đối số bắt buộc. Truyền đối số --help khi chạy 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
```

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

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 thư viện ứng dụng googleads/data-manager trong dự án của bạn.

Không bắt buộc: Cài đặt thư viện tiện ích

Ngoài thư viện ứng dụng, bạn có thể cài đặt thư viện tiện ích để hỗ trợ các tác vụ phổ biến như định dạng dữ liệu để nhập.

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 vào thư viện tiện ích:
```
composer require googleads/data-manager-util
```
Để đị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 mã mẫu

Duyệt xem các mã mẫu trong thư mục con samples hoặc trên GitHub.

Cách chạy mẫu:

Sao chép kho lưu trữ GitHub tại thẻ v0.4.0:

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

Chuyển đến thư mục data-manager-php/samples.
Cài đặt các phần phụ thuộc để chạy mẫu:
```
composer install
```
Chạy mẫu, truyền mọi đối số bắt buộc. Truyền đối số --help khi chạy 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:
```
php audiences/ingest_audience_members.php --help
```

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

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: Cài đặt thư viện tiện ích

Ngoài thư viện ứng dụng, bạn có thể cài đặt thư viện tiện ích để hỗ trợ các thao tác phổ biến như định dạng và mã hoá dữ liệu để nhập.

Trong dự án Python, hãy khai báo phần phụ thuộc vào thư viện tiện ích google-ads-datamanager-util.

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.4.0
```
Hoặc cài đặt trực tiếp thư viện tiện ích:
```
pip install google-ads-datamanager-util==0.4.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 mã mẫu

Sao chép kho lưu trữ GitHub tại thẻ v0.4.0:

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

Chuyển đến thư mục data-manager-python.
Cài đặt các phần phụ thuộc để chạy mẫu:
```
pip install -r samples/requirements.txt
```
Chạy mẫu, truyền mọi đối số bắt buộc. Truyền đối số --help khi chạy 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 ra một câu lệnh sử dụng:
```
python3 samples/audiences/ingest_audience_members.py --help
```

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

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.
Tìm hiểu cách triển khai giải pháp tích hợp của bạn vào môi trường thực tế.
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

Tiếp

Kỹ năng của nhân viên hỗ trợ

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: Cài đặt thư viện tiện ích

Duyệt xem mã mẫu

Go

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

Java

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

Không bắt buộc: Cài đặt thư viện tiện ích

Duyệt xem mã mẫu

Node.js

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

Không bắt buộc: Cài đặt thư viện tiện ích

Duyệt xem mã mẫu

PHP

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

Không bắt buộc: Cài đặt thư viện tiện ích

Duyệt xem mã mẫu

Python

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

Không bắt buộc: Cài đặt thư viện tiện ích

Duyệt xem 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