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 Google Cloud.
2. Một Tài khoản Google có quyền serviceusage.services.enable đối với dự án của bạn trên Google Cloud 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 API Trình quản lý dữ liệu, hãy nhấp vào Bật API Trình quản lý dữ liệu hoặc làm theo hướng dẫn để thực hiện bước này theo cách thủ công.

Bật Data Manager API

Nếu bạn không tìm thấy Data Manager API hoặc không Bật 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 xác thực

Bạn có thể sử dụng bất kỳ Phương pháp xác thực nào tại Google ngoài khóa API. Bạn nên xem xét cách Chọn phương thức xác thực phù hợp cho trường hợp sử dụng của bạn để quyết định xem phương pháp nào phù hợp với trường hợp sử dụng của bạn.

Hai phương thức xác thực phổ biến là tài khoản người dùng và tài khoản dịch vụ:

• Tài khoản người dùng: Đại diện cho những người tương tác trực tiếp với các API và dịch vụ của Google.
• Tài khoản dịch vụ: Đại diện cho ứng dụng, không phải người dùng. Chúng cho phép ứng dụng của bạn quản lý xác thực và ủy quyền. Ví dụ: nếu một ứng dụng cần truy cập tài nguyên Google Cloud.

Tích hợp của bạn có thể sử dụng Thông tin xác thực mặc định của ứng dụng (ADC) để tự động tìm thông tin xác thực từ môi trường để bạn không phải thay đổi mã máy khách để xác thực.

Chọn Tài khoản người dùng hoặc Mạo danh tài khoản dịch vụ để thiết lập ADC:

Tài khoản người dùng Mạo danh tài khoản dịch vụ

Sau đây là các bước xác thực bằng thông tin đăng nhập tài khoản người dùng:

1. Định cấu hình chế độ cài đặt Nền tảng xác thực của Google cho dự án của bạn.

   Quan trọng: Bất kỳ ứng dụng Google Cloud nào được sử dụng để lấy thông tin đăng nhập của người dùng cho phạm vi API Data Manager đều phải trải qua xác minh Google OAuth để tránh màn hình giao diện người dùng chưa được xác minh cho người dùng. Bạn không bắt buộc phải xác minh OAuth của Google đối với tài khoản dịch vụ.

   1. Mở trang Thương hiệu trong Google Cloud Console.

   2. Chọn dự án của bạn.

   3. Điền thông tin vào biểu mẫu rồi nhấp vào Tạo.

2. Vì phạm vi Data Manager API là một phạm vi nhạy cảm, nên bạn phải thực hiện các bước sau:

   1. Chuyển đến phần cài đặt Quyền truy cập vào dữ liệu cho dự án của bạn.

   2. Nhấp vào Thêm hoặc xóa phạm vi.

   3. Đánh dấu vào hộp bên cạnh Data Manager API trong danh sách các phạm vi, rồi nhấp vào Cập nhật.

   4. Nhấp vào Lưu.

   5. Chuyển đến phần Đối tượng trong Google Cloud Console rồi cập nhật Trạng thái xuất bản và Loại người dùng. Tìm hiểu thêm về các chế độ cài đặt này trong phần Quản lý đối tượng ứng dụng.

3. Nhấp vào Tạo ứng dụng khách OAuth2 để tạo ứng dụng khách OAuth2 trong dự án hoặc làm theo hướng dẫn để tạo ứng dụng khách OAuth2 trên máy tính để bàn.

   Tạo ứng dụng OAuth2

   Ở bước cuối cùng, hãy nhấp vào TẢI XUỐNG CẤU HÌNH MÁY KHÁCH và ghi lại vị trí tải xuống mà bạn chọn.

4. Tạo tệp ADC cục bộ bằng cách chạy lệnh sau. Lệnh này sẽ khởi chạy một luồng web trong đó bạn sẽ được nhắc đăng nhập vào Tài khoản Google mà bạn đang sử dụng với API.

   Thay thế PATH_TO_CLIENT_JSON bằng tên tệp JSON bạn đã tải xuống.

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

5. Xác nhận rằng bạn đã thiết lập thông tin đăng nhập chính xác bằng lệnh sau. Nếu thành công, lệnh sẽ in mã thông báo truy cập vào bảng điều khiển.

   gcloud auth application-default print-access-token
   

Lưu ý: Bạn phải có phạm vi https://www.googleapis.com/auth/datamanager cho mọi thông tin đăng nhập được dùng với Data Manager API.

Để tìm hiểu thêm về quy trình xác thực và thông tin xác thực 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 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 của bạn quyền truy cập vào Destination.

• Nếu bạn đang sử dụng tài khoản Google Ads hoặc tài khoản đối tác dữ liệu, hãy làm theo hướng dẫn để thêm email của người dùng vào tài khoản.
• Nếu bạn đang sử dụng tài khoản Display & Video 360, hãy làm theo hướng dẫn để thêm email của người dùng vào tài khoản.

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

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

REST

1. Cập nhật các chỗ 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.

   Xóa thuộc tính linkedAccount của mục nhập trong destinations nếu bạn không truy cập operatingAccount bằng liên kết sản phẩm đã thiết lập.

   #!/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"
         },
         "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 máy khách.NET để thêm phần phụ thuộc vào thư viện máy khách trong dự án của bạn.

Tùy chọn: Tải thư viện tiện ích và mẫu mã.

1. Tải xuống và giải nén data-manager-dotnet.tar.gz.

2. Trong dự án .NET của bạn, hãy khai báo sự phụ thuộc ProjectReference vào thư viện tiện ích. Thay thế PATH_TO_UTILITY_LIBRARY bằng vị trí mà bạn đã trích xuất thư mục data-manager-dotnet từ data-manager-dotnet.tar.gz.

   <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
   

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

4. Duyệt xem các mã mẫu trong thư mục con samples.

   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ẫ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

1. Tải xuống và giải nén 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 để xây dựng và xuất bản thư viện lên kho lưu trữ Maven cục bộ của bạn để sử dụng với Maven hoặc Gradle.

   ./gradlew install
   

4. Trong dự án Java của bạn, hãy khai báo sự phụ thuộc vào thư viện API Data Manager.

   Gradle:

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

   Chuyên gia:

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

Tùy chọn: Tải thư viện tiện ích và mẫu mã.

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

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

2. Chuyển đến thư mục data-manager-java.

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

   Chuyên gia:

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

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

6. Duyệt các mẫu mã 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 sẽ chạy mẫu IngestAudienceMembers và in ra 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

1. Tải xuống 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 lệnh sau để biên dịch và đóng gói thư viện máy khách vào tệp .tgz để sử dụng với npm.

   npm pack
   

   Lệnh này tạo một kho lưu trữ có tên google-cloud-datamanager-0.1.4.tgz. Hãy ghi lại vị trí tệp để bạn có thể sử dụng ở các bước tiếp theo.

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

   {
      "dependencies": {
         ...
         "@google-cloud/datamanager": "file:PATH_TO_CLIENT_LIBRARY/google-cloud-datamanager-0.1.4.tgz",
         ...
      }
   }
   

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

1. Tải xuống và giải nén data-manager-node.tar.gz.
2. Chuyển đến thư mục data-manager-node.

3. Chuyển sang thư mục util.

   cd util
   

4. 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.1.0.tgz. Hãy ghi lại vị trí tệp để bạn có thể sử dụng ở các bước tiếp theo.

5. Trong dự án Node.js của bạn, hãy khai báo sự phụ thuộc vào thư viện tiện ích API Data Manager 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.1.0.tgz.

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.1.0.tgz",
         ...
      }
   }
   

   Để định dạng dữ liệu, hãy sử dụng tiện ích UserDataFormatter trong dự án Node.js.

6. Duyệt các mẫu mã trong thư mục con samples. Chạy mẫu theo các bước sau:

   1. Sao chép google-cloud-datamanager-0.1.4.tgz vào thư mục cha của thư mục data-manager-node.

   2. Điều hướng đến thư mục samples trong data-manager-node.

   3. Chạy lệnh sau để biên dịch các mẫu.

      npm run compile
      

   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ẫu để in câu lệnh sử dụng với các tham số dự kiến.

      Ví dụ: lệnh sau sẽ chạy mẫu ingest_audience_members và in ra câu lệnh sử dụng:

      npx ts-node audiences/ingest_audience_members.ts --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

1. Tải xuống và giải nén google-cloud-ads-datamanager-v1-php.tar.gz.
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ụ 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ủ, hãy khai báo sự phụ thuộc vào thư viện API Data Manager bằng cách thực hiện 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 sự phụ thuộc vào thư viện API Data Manager.

      "require": {
         "googleads/data-manager": "0.1.4"
      }
      

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ụ 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ủ, hãy khai báo sự phụ thuộc vào thư viện tiện ích bằng cách thực hiện theo các bước sau:

   1. Thêm mục vào 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 sự 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 các mẫu mã trong thư mục con samples. Chạy mẫu theo 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 mà bạn đã trích xuất thư viện máy khách.

      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 bất kỳ đối số nào cần thiết. Truyền đối số --help khi chạy 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.

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.

Tùy chọn: Tải thư viện tiện ích và mẫu mã.

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 của bạn, hãy khai báo sự 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
   

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 các mẫu mã trong thư mục con samples. Để 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ẫ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 máy khách Ruby để thêm phần phụ thuộc vào thư viện máy khách 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 đối tượng.
• Tìm hiểu thêm về gửi sự kiện.
• Duyệt tài liệu tham khảo REST hoặc RPC.

Mẹo: Để thử bất kỳ phương pháp nào, hãy truy cập tham chiếu REST và nhấp vào nút API trên thanh công cụ trên trang của phương pháp đó. Đọc thêm tại Hiển thị API Explorer và thực thi phương thức.