Hãy tham gia cùng chúng tôi trực tiếp trên Discord trên máy chủ Cộng đồng quảng cáo và đo lường của Google và trên YouTube vào ngày 23 tháng 4 lúc 21:00 (giờ Việt Nam)! Chúng tôi sẽ thảo luận về các tính năng mới được thêm vào phiên bản 24 của API Google Ads.

Bắt đầu nhanh

Hướng dẫn bắt đầu nhanh này giúp bạn thực hiện lệnh gọi API đầu tiên tới API Google Ads.

Khái niệm chính

Mã của nhà phát triển: Mã của nhà phát triển là một chuỗi gồm chữ và số dài 22 ký tự, xác định ứng dụng của bạn với các máy chủ Google Ads API. Bạn cần có mã này để thực hiện lệnh gọi API.
Cấp truy cập API: Cấp truy cập API của mã của nhà phát triển kiểm soát số lệnh gọi API mà bạn có thể thực hiện mỗi ngày và các môi trường mà bạn có thể thực hiện lệnh gọi API.
**Tài khoản người quản lý Google Ads:** Tài khoản người quản lý Google Ads được dùng để quản lý các tài khoản Google Ads khác. Bạn có thể dùng tài khoản người quản lý Google Ads để quản lý tài khoản khách hàng Google Ads hoặc các tài khoản người quản lý Google Ads khác. Bạn cần có tài khoản người quản lý Google Ads để nhận mã của nhà phát triển.
Tài khoản khách hàng Google Ads: Tài khoản Google Ads mà bạn đang thực hiện lệnh gọi API.
Mã khách hàng: Mã gồm 10 chữ số xác định một tài khoản khách hàng Google Ads. Nếu bạn sao chép mã này từ giao diện người dùng Google Ads, hãy nhớ xoá dấu gạch ngang.
OAuth 2.0: OAuth 2.0 là một giao thức tiêu chuẩn trong ngành để uỷ quyền, được tất cả các API của Google sử dụng. Bạn cần có tài khoản dịch vụ và khoá để tạo thông tin xác thực OAuth 2.0 nhằm thực hiện lệnh gọi API.
Dự án Google Cloud: Dự án Google Cloud tạo cơ sở để tạo, bật và sử dụng tất cả các dịch vụ của Google, bao gồm cả việc quản lý API và thông tin xác thực API OAuth 2.0. Bạn có thể tạo một dự án từ Google Cloud Console.
Tài khoản dịch vụ: Một loại Tài khoản Google đặc biệt thuộc về ứng dụng của bạn chứ không phải thuộc về người dùng cá nhân. Tài khoản này được dùng để xác thực ứng dụng của bạn với Google Ads API. Bạn cần có dự án Google Cloud để nhận tài khoản dịch vụ.
Khoá tài khoản dịch vụ: Tệp thông tin xác thực ứng dụng JSON chứa khoá riêng tư cho tài khoản dịch vụ của bạn. Khoá này được dùng để tạo thông tin xác thực OAuth 2.0 nhằm xác thực tài khoản dịch vụ khi thực hiện lệnh gọi API Google Ads. Bạn cần có tài khoản dịch vụ để nhận khoá tài khoản dịch vụ.

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

Để thực hiện lệnh gọi API Google Ads, bạn nên hoàn tất các bước sau.

Nhận mã của nhà phát triển

Nếu đã đăng ký nhận mã của nhà phát triển trong quá khứ, bạn có thể tìm thấy mã đó bằng cách truy cập vào Trung tâm API khi đăng nhập vào tài khoản người quản lý Google Ads.

Truy cập vào Trung tâm API

Nếu chưa có mã của nhà phát triển, bạn có thể đăng ký nhận mã này trong Trung tâm API.

Chuyển đến Trung tâm API trong trình duyệt web. Đăng nhập vào tài khoản người quản lý Google Ads nếu được nhắc. Tạo tài khoản người quản lý Google Ads nếu bạn chưa có.
Hoàn tất biểu mẫu Quyền truy cập API và chấp nhận Điều khoản và điều kiện.
- Đảm bảo rằng thông tin của bạn là chính xác và URL trang web của công ty bạn đang hoạt động. Nếu trang web không hoạt động, Google có thể không xử lý được đơn đăng ký của bạn và từ chối đơn đăng ký đó.
- Đảm bảo rằng email liên hệ về API mà bạn cung cấp dẫn đến một hộp thư đến được theo dõi thường xuyên. Nhóm tuân thủ API của Google có thể liên hệ với địa chỉ email này trong quá trình xem xét để làm rõ. Nếu không liên hệ được với bạn, Google có thể không tiếp tục xử lý đơn đăng ký của bạn.
- Bạn có thể chỉnh sửa email liên hệ về API trong Trung tâm API. Hãy cập nhật thông tin này, ngay cả sau quá trình đăng ký, để Google có thể gửi cho bạn các thông báo quan trọng về dịch vụ.

Sau khi bạn hoàn tất quy trình đăng ký, mã của nhà phát triển sẽ xuất hiện trong Trung tâm API với trạng thái Đang chờ phê duyệt. Mã của nhà phát triển hiện có cấp Quyền truy cập vào tài khoản thử nghiệm.

Định cấu hình dự án Bảng điều khiển API của Google

Dự án Bảng điều khiển API của Google được dùng để quản lý API của Google và thông tin xác thực API OAuth 2.0. Bạn có thể tìm thấy các dự án Bảng điều khiển API của Google hiện có hoặc tạo một dự án bằng cách truy cập vào Bảng điều khiển API của Google.

Mở Bảng điều khiển API của Google

Bắt đầu bằng cách bật API Google Ads trong dự án của bạn:

Bật API Google Ads

Tiếp theo, bạn cần có tài khoản dịch vụ và khoá tài khoản dịch vụ để thực hiện lệnh gọi API. Nếu đang sử dụng một API khác của Google và đã tạo tài khoản dịch vụ và khoá OAuth 2.0, bạn có thể bỏ qua bước này và sử dụng lại thông tin xác thực hiện có.

Cách tạo tài khoản dịch vụ và khoá

Trong bảng điều khiển Cloud, hãy chuyển đến trình đơn Trình đơn > IAM và quản trị > Tài khoản dịch vụ.
Chuyển đến phần Tài khoản dịch vụ
Chọn tài khoản dịch vụ.
Nhấp vào Khoá > Thêm khoá > Tạo khoá mới.
Chọn JSON, sau đó nhấp vào Tạo.
Cặp khoá công khai/riêng tư mới của bạn sẽ được tạo và tải xuống máy của bạn dưới dạng một tệp mới. Lưu tệp JSON đã tải xuống dưới dạng credentials.json trong thư mục làm việc. Tệp này là bản sao duy nhất của khoá này.
Nhấp vào Close (Đóng).

Định cấu hình tài khoản khách hàng Google Ads

Bắt đầu bằng cách xác định tài khoản Google Ads mà bạn đang thực hiện lệnh gọi API. Loại tài khoản mà bạn có thể thực hiện lệnh gọi API phụ thuộc vào Cấp truy cập API của mã của nhà phát triển. Kiểm tra Trung tâm API để tìm hiểu cấp truy cập API của bạn.

Cấp truy cập Trình khám phá, Cơ bản và Tiêu chuẩn

Bạn có thể thực hiện lệnh gọi đến tài khoản sản xuất Google Ads. Tuy nhiên, bạn có thể tạo tài khoản thử nghiệm Google Ads bằng cách làm theo hướng dẫn trên thẻ Quyền truy cập vào tài khoản thử nghiệm nếu cần.

Cấp truy cập vào tài khoản thử nghiệm

Bạn không thể sử dụng mã của nhà phát triển để thực hiện lệnh gọi API đến tài khoản sản xuất Google Ads. Bạn chỉ có thể thực hiện lệnh gọi API đối với tài khoản thử nghiệm Google Ads.

Cách tạo tài khoản thử nghiệm Google Ads

Hướng dẫn sau đây sẽ tạo một tài khoản người quản lý thử nghiệm Google Ads và một tài khoản nhà quảng cáo Google Ads thử nghiệm bên dưới tài khoản đó.

Nhấp vào nút màu xanh dương để tạo tài khoản người quản lý thử nghiệm Google Ads. Nếu được nhắc, hãy đăng nhập bằng một Tài khoản Google không liên kết với tài khoản người quản lý sản xuất Google Ads của bạn. Nếu bạn chưa có tài khoản, hãy sử dụng nút Tạo tài khoản trên trang đó để tạo một Tài khoản Google mới.

Tạo tài khoản người quản lý thử nghiệm Google Ads
Khi ở trong tài khoản người quản lý thử nghiệm Google Ads, hãy tạo tài khoản khách hàng thử nghiệm Google Ads: Nhấp vào Tài khoản > > Tạo tài khoản mới rồi điền vào biểu mẫu. Mọi tài khoản Google Ads mà bạn tạo từ tài khoản người quản lý thử nghiệm Google Ads đều tự động là tài khoản thử nghiệm Google Ads.
Bạn có thể tạo một vài chiến dịch trong tài khoản khách hàng thử nghiệm Google Ads trên trang Google Ads.

Để thực hiện lệnh gọi API đến một khách hàng Google Ads, bạn phải cấp quyền truy cập và các quyền thích hợp cho tài khoản dịch vụ của mình đối với tài khoản khách hàng Google Ads. Để thực hiện việc này, bạn cần có quyền truy cập quản trị vào tài khoản khách hàng.

Cách cấp quyền truy cập tài khoản dịch vụ vào tài khoản Google Ads

Bắt đầu bằng cách đăng nhập vào tài khoản Google Ads với tư cách quản trị viên.
Chuyển đến Quản trị viên > Quyền truy cập và bảo mật.
Nhấp vào nút trong thẻ Người dùng.
Nhập email của tài khoản dịch vụ vào ô nhập dữ liệu Email. Chọn cấp truy cập tài khoản thích hợp rồi nhấp vào nút Thêm tài khoản. Xin lưu ý rằng chúng tôi không hỗ trợ cấp truy cập Email cho tài khoản dịch vụ.
Tài khoản dịch vụ được cấp quyền truy cập.
[Không bắt buộc] Theo mặc định, bạn không thể cấp quyền truy cập quản trị cho tài khoản dịch vụ. Nếu lệnh gọi API của bạn yêu cầu quyền truy cập quản trị, bạn có thể nâng cấp quyền truy cập như sau.
1. Nhấp vào mũi tên thả xuống bên cạnh cấp truy cập của tài khoản dịch vụ trong cột Cấp truy cập.
2. Chọn Quản trị viên trong danh sách thả xuống.

Tải công cụ và thư viện ứng dụng xuống

Bạn có thể chọn tải thư viện ứng dụng hoặc ứng dụng HTTP xuống, tuỳ thuộc vào cách bạn muốn thực hiện lệnh gọi API.

Sử dụng thư viện ứng dụng

Tải xuống và cài đặt thư viện ứng dụng mà bạn chọn.

Sử dụng ứng dụng HTTP (REST)

curl

Tải xuống và cài đặt curl, công cụ dòng lệnh để truyền dữ liệu thông qua URL.

Google Cloud CLI

Làm theo hướng dẫn để cài đặt gcloud CLI.

Chúng tôi đã xác minh rằng hướng dẫn cho phần còn lại của hướng dẫn này hoạt động với phiên bản sau đây của công cụ gcloud và có thể không hoạt động với các phiên bản trước do sự khác biệt về hành vi của ứng dụng hoặc các tuỳ chọn dòng lệnh.

:~$ gcloud version
Google Cloud SDK 492.0.0
alpha 2024.09.06
beta 2024.09.06
bq 2.1.8
bundled-python3-unix 3.11.9
core 2024.09.06
enterprise-certificate-proxy 0.3.2
gcloud-crc32c 1.0.0
gsutil 5.30

Tạo lệnh gọi API

Lưu ý quan trọng: Bạn có thể nhận thấy rằng hướng dẫn về thư viện ứng dụng đề cập đến một chế độ cài đặt bổ sung có tên là login_customer_id. Để hoàn tất hướng dẫn này, bạn có thể chỉ định mã khách hàng gồm 10 chữ số cho chế độ cài đặt này, không có dấu gạch ngang. Sau khi hoàn tất hướng dẫn này, bạn có thể đọc mô hình truy cập Google Ads để tìm hiểu thêm về chế độ cài đặt này.

Chọn ứng dụng bạn muốn để xem hướng dẫn về cách thực hiện lệnh gọi API:

Java

Các cấu phần phần mềm của thư viện ứng dụng được xuất bản lên kho lưu trữ trung tâm Maven. Thêm thư viện ứng dụng làm phần phụ thuộc vào dự án của bạn như sau:

Phần phụ thuộc Maven là:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>43.0.0</version>
</dependency>

Phần phụ thuộc Gradle là:

implementation 'com.google.api-ads:google-ads:43.0.0'

Bạn cũng nên sử dụng Bảng kê khai thành phần API Google Ads (BOM) để quản lý các phiên bản phần phụ thuộc. Hãy xem hướng dẫn về BOM để biết hướng dẫn.

Tạo tệp ~/ads.properties có nội dung sau:

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Tạo đối tượng GoogleAdsClient như sau:

GoogleAdsClient googleAdsClient = null;
try {
  googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
} catch (FileNotFoundException fnfe) {
  System.err.printf(
      "Failed to load GoogleAdsClient configuration from file. Exception: %s%n",
      fnfe);
  System.exit(1);
} catch (IOException ioe) {
  System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
  System.exit(1);
}

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    String query = "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";
    // Constructs the SearchGoogleAdsStreamRequest.
    SearchGoogleAdsStreamRequest request =
        SearchGoogleAdsStreamRequest.newBuilder()
            .setCustomerId(Long.toString(customerId))
            .setQuery(query)
            .build();

    // Creates and issues a search Google Ads stream request that will retrieve all campaigns.
    ServerStream<SearchGoogleAdsStreamResponse> stream =
        googleAdsServiceClient.searchStreamCallable().call(request);

    // Iterates through and prints all of the results in the stream response.
    for (SearchGoogleAdsStreamResponse response : stream) {
      for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
        System.out.printf(
            "Campaign with ID %d and name '%s' was found.%n",
            googleAdsRow.getCampaign().getId(), googleAdsRow.getCampaign().getName());
      }
    }
  }
}GetCampaigns.java

C#

Các gói thư viện ứng dụng được xuất bản lên kho lưu trữ Nuget.org. Bắt đầu bằng cách thêm một tham chiếu nuget vào gói Google.Ads.GoogleAds.

dotnet add package Google.Ads.GoogleAds --version 25.1.0

Tạo đối tượng GoogleAdsConfig bằng các chế độ cài đặt có liên quan rồi sử dụng đối tượng đó để tạo đối tượng GoogleAdsClient.

GoogleAdsConfig config = new GoogleAdsConfig()
{
    DeveloperToken = "******",
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = ******
};
GoogleAdsClient client = new GoogleAdsClient(config);

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn. Hướng dẫn này không đề cập đến thông tin chi tiết về báo cáo.

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsService = client.GetService(
        Services.V23.GoogleAdsService);

    // Create a query that will retrieve all campaigns.
    string query = @"SELECT
                    campaign.id,
                    campaign.name,
                    campaign.network_settings.target_content_network
                FROM campaign
                ORDER BY campaign.id";

    try
    {
        // Issue a search request.
        googleAdsService.SearchStream(customerId.ToString(), query,
            delegate (SearchGoogleAdsStreamResponse resp)
            {
                foreach (GoogleAdsRow googleAdsRow in resp.Results)
                {
                    Console.WriteLine("Campaign with ID {0} and name '{1}' was found.",
                        googleAdsRow.Campaign.Id, googleAdsRow.Campaign.Name);
                }
            }
        );
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}GetCampaigns.cs

PHP

Các gói thư viện ứng dụng được xuất bản lên kho lưu trữ Packagist. Chuyển sang thư mục gốc của dự án rồi chạy lệnh sau để cài đặt thư viện và tất cả các phần phụ thuộc của thư viện đó trong thư mục vendor/ của thư mục gốc của dự án.

composer require googleads/google-ads-php:32.2.0

Tạo bản sao của tệp google_ads_php.ini từ kho lưu trữ GitHub rồi sửa đổi tệp đó để thêm thông tin xác thực của bạn.

[GOOGLE_ADS]
developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/adwords"

Tạo một thực thể của đối tượng GoogleAdsClient.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    $googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
    // Creates a query that retrieves all campaigns.
    $query = 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id';
    // Issues a search stream request.
    /** @var GoogleAdsServerStreamDecorator $stream */
    $stream = $googleAdsServiceClient->searchStream(
        SearchGoogleAdsStreamRequest::build($customerId, $query)
    );

    // Iterates over all rows in all messages and prints the requested field values for
    // the campaign in each row.
    foreach ($stream->iterateAllElements() as $googleAdsRow) {
        /** @var GoogleAdsRow $googleAdsRow */
        printf(
            "Campaign with ID %d and name '%s' was found.%s",
            $googleAdsRow->getCampaign()->getId(),
            $googleAdsRow->getCampaign()->getName(),
            PHP_EOL
        );
    }
}GetCampaigns.php

Python

Thư viện ứng dụng được phân phối trên PyPI có thể được cài đặt bằng lệnh pip như sau:

python -m pip install google-ads==29.2.0

Tạo bản sao của tệp google-ads.yaml từ kho lưu trữ GitHub rồi sửa đổi tệp đó để thêm thông tin xác thực của bạn.

developer_token: INSERT_DEVELOPER_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
json_key_file_path: JSON_KEY_FILE_PATH_HERE

Tạo thực thể GoogleAdsClient bằng cách gọi phương thức GoogleAdsClient.load_from_storage. Truyền đường dẫn đến google-ads.yaml của bạn dưới dạng chuỗi đến phương thức khi gọi phương thức đó:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage("path/to/google-ads.yaml")

Thêm trình xử lý vào trình ghi nhật ký của thư viện để cho biết vị trí in nhật ký. Lệnh sau đây sẽ cho trình ghi nhật ký của thư viện biết cách in vào bảng điều khiển (stdout).

import logging
import sys

logger = logging.getLogger('google.ads.googleads.client')
logger.addHandler(logging.StreamHandler(sys.stdout))

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

def main(client: GoogleAdsClient, customer_id: str) -> None:
    ga_service: GoogleAdsServiceClient = client.get_service("GoogleAdsService")

    query: str = """
        SELECT
          campaign.id,
          campaign.name
        FROM campaign
        ORDER BY campaign.id"""

    # Issues a search request using streaming.
    stream: Iterator[SearchGoogleAdsStreamResponse] = ga_service.search_stream(
        customer_id=customer_id, query=query
    )

    for batch in stream:
        rows: List[GoogleAdsRow] = batch.results
        for row in rows:
            print(
                f"Campaign with ID {row.campaign.id} and name "
                f'"{row.campaign.name}" was found.'
            )get_campaigns.py

Ruby

Các Ruby gem cho thư viện ứng dụng được xuất bản lên trang web lưu trữ gem Rubygems gem hosting site. Bạn nên cài đặt bằng bundler. Thêm một dòng vào Gemfile:

gem 'google-ads-googleads', '~> 38.0.0'

Sau đó, chạy:

bundle install

Tạo bản sao của tệp google_ads_config.rb từ kho lưu trữ GitHub rồi sửa đổi tệp đó để thêm thông tin xác thực của bạn.

Google::Ads::GoogleAds::Config.new do |c|
  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  c.keyfile = 'JSON_KEY_FILE_PATH'
end

Tạo thực thể GoogleAdsClient bằng cách truyền đường dẫn đến vị trí bạn lưu giữ tệp này.

client = Google::Ads::GoogleAds::GoogleAdsClient.new('path/to/google_ads_config.rb')

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

def get_campaigns(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new

  responses = client.service.google_ads.search_stream(
    customer_id: customer_id,
    query: 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id',
  )

  responses.each do |response|
    response.results.each do |row|
      puts "Campaign with ID #{row.campaign.id} and name '#{row.campaign.name}' was found."
    end
  end
endget_campaigns.rb

Perl

Thư viện được phân phối trên CPAN. Bắt đầu bằng cách sao chép kho lưu trữ google-ads-perl trong thư mục bạn chọn.

git clone https://github.com/googleads/google-ads-perl.git

Chuyển sang thư mục google-ads-perl rồi chạy lệnh sau tại dấu nhắc lệnh để cài đặt tất cả các phần phụ thuộc cần thiết để sử dụng thư viện.

cd google-ads-perl
cpan install Module::Build
perl Build.PL
perl Build installdeps

Tạo bản sao của tệp googleads.properties từ kho lưu trữ GitHub rồi sửa đổi tệp đó để thêm thông tin xác thực của bạn.

jsonKeyFilePath=JSON_KEY_FILE_PATH
developerToken=INSERT_DEVELOPER_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Tạo thực thể Client bằng cách truyền đường dẫn đến vị trí bạn lưu giữ tệp này.

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

sub get_campaigns {
  my ($api_client, $customer_id) = @_;

  # Create a search Google Ads stream request that will retrieve all campaigns.
  my $search_stream_request =
    Google::Ads::GoogleAds::V24::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
    ->new({
      customerId => $customer_id,
      query      =>
        "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
    });

  # Get the GoogleAdsService.
  my $google_ads_service = $api_client->GoogleAdsService();

  my $search_stream_handler =
    Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
      service => $google_ads_service,
      request => $search_stream_request
    });

  # Issue a search request and process the stream response to print the requested
  # field values for the campaign in each row.
  $search_stream_handler->process_contents(
    sub {
      my $google_ads_row = shift;
      printf "Campaign with ID %d and name '%s' was found.\n",
        $google_ads_row->{campaign}{id}, $google_ads_row->{campaign}{name};
    });

  return 1;
}get_campaigns.pl

curl

Bắt đầu bằng cách đặt tài khoản dịch vụ làm thông tin xác thực đang hoạt động trong gcloud CLI.

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

Tiếp theo, tìm nạp mã truy cập OAuth 2.0 cho API Google Ads.

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

Tiếp theo, chạy báo cáo chiến dịch bằng phương thức GoogleAdsService.SearchStream để truy xuất các chiến dịch trong tài khoản của bạn.

curl -i -X POST https://googleads.googleapis.com/v24/customers/CUSTOMER_ID/googleAds:searchStream \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "developer-token: DEVELOPER_TOKEN" \
   -H "login-customer-id: LOGIN_CUSTOMER_ID" \
   --data-binary "@query.json"

Nội dung của query.json như sau:

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}

Nếu bạn gặp lỗi khi thực hiện lệnh gọi đầu tiên, hãy xem Xử lý lỗi API để được hướng dẫn về cách khắc phục sự cố.

Bắt đầu nhanh 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.

Khái niệm chính

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

Nhận mã của nhà phát triển

Cách đăng ký nhận mã của nhà phát triển

Định cấu hình dự án Bảng điều khiển API của Google

Cách tạo tài khoản dịch vụ và khoá

Định cấu hình tài khoản khách hàng Google Ads

Cấp truy cập Trình khám phá, Cơ bản và Tiêu chuẩn

Cấp truy cập vào tài khoản thử nghiệm

Cách tạo tài khoản thử nghiệm Google Ads

Cách cấp quyền truy cập tài khoản dịch vụ vào tài khoản Google Ads

Tải công cụ và thư viện ứng dụng xuống

Sử dụng thư viện ứng dụng

Sử dụng ứng dụng HTTP (REST)

Tạo lệnh gọi API

Java

C#

PHP

Python

Ruby

Perl

curl

Bắt đầu nhanh