Bắt đầu

Sử dụng API Google Ad Manager (Bản thử nghiệm) để đọc dữ liệu Ad Manager và chạy báo cáo.

Để tạo yêu cầu API đầu tiên, hãy hoàn thành các bước sau:

Có quyền truy cập vào mạng Ad Manager

Nếu bạn chưa có tài khoản, hãy đăng ký tài khoản Ad Manager.

Bật API Ad Manager

Bật Ad Manager API trong Dự án Google API Console.

Xác thực

Tất cả các yêu cầu API phải được xác thực bằng OAuth2.

Thư viện ứng dụng API Ad Manager đọc thông tin xác thực từ Thông tin xác thực mặc định của ứng dụng. Bạn có thể thiết lập các biến này bằng cách sử dụng biến môi trường hoặc gcloud.

Tài khoản dịch vụ

Linux hoặc macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Thông tin xác thực người dùng

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID

Để biết thêm thông tin về cách chọn loại thông tin xác thực và tạo thông tin xác thực, hãy xem hướng dẫn xác thực.

Thiết lập thư viện ứng dụng

Java

Đối với Maven:

<!-- pom.xml -->
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>ad-manager</artifactId>
   <version>0.1.0</version>
</dependency>

Đối với Gradle:

implementation 'com.google.api-ads:ad-manager:0.1.0'

Python

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

pip install google-ads-admanager

.NET

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

Từ .NET CLI:

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

Dưới dạng tham chiếu gói:

<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

Tạo yêu cầu đầu tiên

Java

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

  public static void main(String[] args) throws Exception {
    syncGetNetwork();
  }

  public static void syncGetNetwork() throws Exception {
    try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
      GetNetworkRequest request =
          GetNetworkRequest.newBuilder()
              .setName(NetworkName.of("[NETWORK_CODE]").toString())
              .build();
      Network response = networkServiceClient.getNetwork(request);
    }
  }
}

Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về Java.

Python

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)

Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về Python.

.NET

    using Google.Ads.AdManager.V1;

    public sealed partial class GeneratedNetworkServiceClientSnippets
    {
        public void GetNetwork()
        {
            // Create client
            NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
            // Initialize request argument(s)
            string name = "networks/[NETWORK_CODE]";
            // Make the request
            Network response = networkServiceClient.GetNetwork(name);
        }
    }

Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về.NET.

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE