Trang này được dịch bởi Cloud Translation API.

Bắt đầu

API Campaign Manager 360 cung cấp quyền truy cập có lập trình vào thông tin từ tài khoản Campaign Manager 360 của bạn. Thuộc tính này được dùng để quản lý và tạo các chiến dịch cũng như báo cáo, giống như cách bạn làm thông qua các dịch vụ web Campaign Manager 360 và Trình tạo báo cáo.

Hướng dẫn này mô tả cách bắt đầu sử dụng API Campaign Manager 360.

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

Trước khi sử dụng API Campaign Manager 360, bạn cần thực hiện một số bước tiên quyết như sau:

Bạn phải có tài khoản Campaign Manager 360. Hãy xem Nhà quảng cáo/Đại lý để biết thông tin đăng ký.
Bạn phải bật tài khoản Campaign Manager 360 để sử dụng API. Hầu hết các tài khoản đều bật tính năng này theo mặc định. Nếu bạn không chắc chắn, hãy liên hệ với người đại diện tài khoản của bạn hoặc nhóm hỗ trợ Campaign Manager 360 để được hỗ trợ.
Bạn phải có một hồ sơ người dùng có quyền truy cập vào tài khoản này. Hãy yêu cầu quản trị viên tài khoản Campaign Manager 360 của bạn tạo một hồ sơ người dùng liên kết với tài khoản này.
Kiểm tra quyền hồ sơ người dùng trong giao diện người dùng Campaign Manager 360. Các tuỳ chọn này kiểm soát nội dung mà hồ sơ người dùng có thể truy cập từ API. Không có quyền truy cập riêng vào API.

Tạo dự án

Để bắt đầu sử dụng API Campaign Manager 360, trước tiên, bạn cần tạo hoặc chọn một dự án trong Google API Console và bật API. Việc sử dụng đường liên kết này sẽ hướng dẫn bạn thực hiện quy trình và tự động kích hoạt API Campaign Manager 360.

Đang bật API cho một dự án hiện có...

Các bước sau đây áp dụng cho người dùng đang có dự án và muốn kích hoạt API Campaign Manager 360 cho dự án đó theo cách thủ công.

Để bật API cho dự án, hãy làm như sau:

Mở Thư viện API trong Google API Console. Nếu được nhắc, hãy chọn một dự án hoặc tạo một dự án mới. Thư viện API liệt kê tất cả các API hiện có, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
Nếu API bạn muốn chọn không hiển thị trong danh sách, hãy sử dụng chức năng tìm kiếm để tìm API đó.
Chọn API bạn muốn bật, sau đó nhấp vào nút Enable (Bật).
Nếu bạn nhận được một lời nhắc, hãy bật tính năng thanh toán.
Nếu được nhắc, hãy chấp nhận Điều khoản dịch vụ của API.

Tạo thông tin đăng nhập

Tất cả các yêu cầu bạn đưa ra cho API Campaign Manager 360 đều phải được ủy quyền. Để biết thông tin tổng quan ngắn gọn về việc ủy quyền, hãy đọc về cách ủy quyền và xác định ứng dụng cho Google.

Các hướng dẫn sau đây sẽ hướng dẫn bạn về quy trình tạo mã ứng dụng khách OAuth 2.0 để sử dụng với luồng ứng dụng đã cài đặt. Để xem hướng dẫn về cách tạo thông tin xác thực để sử dụng với quy trình tài khoản dịch vụ, hãy tham khảo hướng dẫn về Tài khoản dịch vụ.

Làm theo các bước để định cấu hình dự án Bảng điều khiển API của Google.
Mở trang Thông tin xác thực trong Bảng điều khiển API.
Nhấp vào TẠO CREDENTIALS > ID ứng dụng khách OAuth.
1. Nếu chưa định cấu hình màn hình xin phép bằng OAuth cho dự án này trước đây, bạn sẽ được hướng dẫn thực hiện ngay. Nhấp vào CẤU HÌNH TÍNH SÀNG ĐỒNG Ý.
2. Chọn loại người dùng rồi nhấp vào TẠO.
3. Điền vào biểu mẫu ban đầu. Bạn có thể chỉnh sửa tên này sau nếu cần. Nhấp vào Lưu khi hoàn tất.
4. Hãy quay lại phần Thông tin xác thực > TẠO THÔNG TIN SÁNG TẠO > Mã ứng dụng khách OAuth để tiếp tục.
Chọn Ứng dụng dành cho máy tính làm loại ứng dụng, đặt tên cho ứng dụng đó rồi nhấp vào Tạo.

Khi hoàn tất, bạn sẽ thấy mã ứng dụng khách OAuth 2.0 và mật khẩu ứng dụng khách. Bạn có thể tải xuống ở định dạng JSON và lưu để sử dụng sau này.

Định cấu hình màn hình xin phép người dùng...

Khi bạn sử dụng OAuth 2.0 để xác thực, người dùng của bạn sẽ được xác thực sau khi họ đồng ý với các điều khoản mà người dùng thấy trên màn hình đồng ý.

Để thiết lập màn hình xin phép cho dự án, hãy làm như sau:

Mở trang Màn hình đồng ý trong Google API Console. Nếu bạn nhận được lời nhắc, hãy chọn một dự án hoặc tạo dự án mới.
Điền thông tin vào biểu mẫu và nhấp vào mục Lưu.

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

API Campaign Manager 360 được xây dựng trên HTTP và JSON, vì vậy, mọi ứng dụng HTTP chuẩn có thể gửi yêu cầu đến API đó và phân tích cú pháp các phản hồi.

Tuy nhiên, thư viện ứng dụng Google API cung cấp tính năng tích hợp ngôn ngữ tốt hơn, tăng cường bảo mật và hỗ trợ đưa ra các yêu cầu được uỷ quyền. Thư viện ứng dụng có sẵn bằng một số ngôn ngữ lập trình. Bằng cách sử dụng các thư viện đó, bạn có thể tránh được việc phải thiết lập yêu cầu HTTP và phân tích cú pháp phản hồi theo cách thủ công.

Để bắt đầu, hãy chọn ngôn ngữ lập trình mà bạn đang sử dụng để phát triển.

C#

Cài đặt thư viện ứng dụng API Campaign Manager 360 mới nhất cho .NET. Bạn nên sử dụng NuGet để quản lý hoạt động cài đặt.

Mở NuGet Package Manager Console và chạy lệnh sau:

Install-Package Google.Apis.Dfareporting.v3_4

Tìm hiểu thêm

Java

Cài đặt thư viện ứng dụng API Campaign Manager 360 mới nhất cho Java. Bạn nên sử dụng Maven để quản lý hoạt động cài đặt.

Thêm phần phụ thuộc sau vào tệp pom.xml:

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v4-rev20220611-1.32.1</version>
  <exclusions>
    <exclusion>
      <groupId>com.google.guava</groupId>
      <artifactId>guava-jdk5</artifactId>
    </exclusion>
  </exclusions>
</dependency>

Tìm hiểu thêm

1.199

Cài đặt thư viện ứng dụng API Campaign Manager 360 mới nhất cho PHP. Bạn nên sử dụng Composer để quản lý hoạt động cài đặt.

Mở một thiết bị đầu cuối và chạy lệnh sau:

composer require google/apiclient

Nếu bạn đã cài đặt thư viện và chỉ muốn cập nhật lên phiên bản mới nhất, hãy làm như sau:

composer update google/apiclient

Tuỳ thuộc vào hệ thống của mình, bạn có thể cần phải thêm sudo vào phần đầu các lệnh này.

Tìm hiểu thêm

Đọc Hướng dẫn dành cho nhà phát triển PHP về API Google API.

Python

Cài đặt thư viện ứng dụng API Campaign Manager 360 mới nhất cho Python. Bạn nên sử dụng pip để quản lý hoạt động cài đặt.

Mở một thiết bị đầu cuối và chạy lệnh sau:

pip install --upgrade google-api-python-client

Tuỳ thuộc vào hệ thống của mình, bạn có thể cần phải thêm sudo vào phần đầu các lệnh này.

Tìm hiểu thêm

Ruby

Cài đặt thư viện ứng dụng API Campaign Manager 360 mới nhất cho Ruby. Bạn nên sử dụng RubyGems để quản lý hoạt động cài đặt.

Mở một thiết bị đầu cuối và chạy lệnh sau:

gem install google-api-client

Nếu bạn đã cài đặt thư viện và chỉ muốn cập nhật lên phiên bản mới nhất, hãy làm như sau:

gem update -y google-api-client

Tuỳ thuộc vào hệ thống của mình, bạn có thể cần phải thêm sudo vào phần đầu các lệnh này.

Tìm hiểu thêm

Đọc Hướng dẫn dành cho nhà phát triển Ruby API của Thư viện ứng dụng Google API.

Bạn có thể tìm thêm các ngôn ngữ được hỗ trợ trên trang Thư viện ứng dụng.

Tạo yêu cầu

Khi đã tạo thông tin xác thực OAuth 2.0 và đã cài đặt thư viện ứng dụng, bạn đã sẵn sàng bắt đầu sử dụng API Campaign Manager 360. Hãy tìm hiểu cách ủy quyền, định cấu hình ứng dụng và thực hiện yêu cầu đầu tiên bằng cách làm theo hướng dẫn bắt đầu nhanh dưới đây.

C#

Tải tệp khóa bí mật của khách hàng và tạo thông tin xác thực ủy quyền.

Lần đầu tiên bạn thực hiện bước này, bạn sẽ được yêu cầu chấp nhận lời nhắc ủy quyền trong trình duyệt của mình. Trước khi chấp nhận, hãy đảm bảo rằng bạn đăng nhập bằng Tài khoản Google có quyền truy cập vào Campaign Manager 360. Ứng dụng của bạn sẽ được ủy quyền truy cập dữ liệu thay cho bất kỳ tài khoản nào hiện đang đăng nhập.

// Load client secrets from the specified JSON file.
GoogleClientSecrets clientSecrets;
using(Stream json = new FileStream(pathToJsonFile, FileMode.Open, FileAccess.Read)) {
  clientSecrets = GoogleClientSecrets.Load(json);
}

// Create an asynchronous authorization task.
//
// Note: providing a data store allows auth credentials to be cached, so they survive multiple
// runs of the application. This avoids prompting the user for authorization every time the
// access token expires, by remembering the refresh token. The "user" value is used to
// identify a specific set of credentials within the data store. You may provide different
// values here to persist credentials for multiple users to the same data store.
Task<UserCredential> authorizationTask = GoogleWebAuthorizationBroker.AuthorizeAsync(
    clientSecrets.Secrets,
    OAuthScopes,
    "user",
    CancellationToken.None,
    dataStore);

// Authorize and persist credentials to the data store.
UserCredential credential = authorizationTask.Result;

Tạo ứng dụng khách dfareporting được ủy quyền.

// Create a Dfareporting service object.
//
// Note: application name should be replaced with a value that identifies your application.
service = new DfareportingService(
    new BaseClientService.Initializer {
      HttpClientInitializer = credential,
      ApplicationName = "C# installed app sample"
    }
);

Thực hiện thao tác.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = service.UserProfiles.List().Execute();

foreach (UserProfile profile in profiles.Items) {
  Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
      profile.ProfileId, profile.UserName);
}

Java

Tải tệp khóa bí mật của khách hàng và tạo thông tin xác thực ủy quyền.

// Load the client secrets JSON file.
GoogleClientSecrets clientSecrets =
    GoogleClientSecrets.load(
        jsonFactory, Files.newBufferedReader(Paths.get(pathToClientSecretsFile), UTF_8));

// Set up the authorization code flow.
//
// Note: providing a DataStoreFactory allows auth credentials to be cached, so they survive
// multiple runs of the program. This avoids prompting the user for authorization every time the
// access token expires, by remembering the refresh token.
GoogleAuthorizationCodeFlow flow =
    new GoogleAuthorizationCodeFlow.Builder(
            httpTransport, jsonFactory, clientSecrets, OAUTH_SCOPES)
        .setDataStoreFactory(dataStoreFactory)
        .build();

// Authorize and persist credentials to the data store.
//
// Note: the "user" value below is used to identify a specific set of credentials in the data
// store. You may provide different values here to persist credentials for multiple users to
// the same data store.
Credential credential =
    new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

Tạo ứng dụng khách dfareporting được ủy quyền.

// Create a Dfareporting client instance.
//
// Note: application name below should be replaced with a value that identifies your
// application. Suggested format is "MyCompany-ProductName/Version.MinorVersion".
Dfareporting reporting =
    new Dfareporting.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("dfareporting-java-installed-app-sample")
        .build();

Thực hiện thao tác.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = reporting.userProfiles().list().execute();
for (int i = 0; i < profiles.getItems().size(); i++) {
  System.out.printf("%d) %s%n", i + 1, profiles.getItems().get(i).getUserName());
}

1.199

Tải tệp khóa bí mật của khách hàng và tạo thông tin xác thực ủy quyền.

// Create a Google_Client instance.
//
// Note: application name should be replaced with a value that identifies
// your application. Suggested format is "MyCompany-ProductName".
$client = new Google_Client();
$client->setAccessType('offline');
$client->setApplicationName('PHP installed app sample');
$client->setRedirectUri(self::OAUTH_REDIRECT_URI);
$client->setScopes(self::$OAUTH_SCOPES);

// Load the client secrets file.
$client->setAuthConfig($pathToJsonFile);

// Try to load cached credentials from the token store. Using a token store
// allows auth credentials to be cached, so they survive multiple runs of
// the application. This avoids prompting the user for authorization every
// time the access token expires, by remembering the refresh token.
if (file_exists($tokenStore) && filesize($tokenStore) > 0) {
    $client->setAccessToken(file_get_contents($tokenStore));
} else {
    // If no cached credentials were found, authorize and persist
    // credentials to the token store.
    print 'Open this URL in your browser and authorize the application.';
    printf("\n\n%s\n\n", $client->createAuthUrl());
    print 'Enter the authorization code: ';
    $code = trim(fgets(STDIN));
    $client->authenticate($code);

    file_put_contents($tokenStore, json_encode($client->getAccessToken()));
}

Tạo ứng dụng khách dfareporting được ủy quyền.

// Create a Dfareporting service object.
$service = new Google_Service_Dfareporting($client);

Thực hiện thao tác.

// Retrieve and print all user profiles for the current authorized user.
$result = $service->userProfiles->listUserProfiles();
foreach ($result['items'] as $userProfile) {
    printf(
        "User profile \"%s\" (ID: %d) found for account %d.\n",
        $userProfile->getUserName(),
        $userProfile->getProfileId(),
        $userProfile->getAccountId()
    );
}

Python

Tải tệp khóa bí mật của khách hàng và tạo thông tin xác thực ủy quyền.

# Set up a Flow object to be used if we need to authenticate.
flow = client.flow_from_clientsecrets(
    path_to_client_secrets_file, scope=OAUTH_SCOPES)

# Check whether credentials exist in the credential store. Using a credential
# store allows auth credentials to be cached, so they survive multiple runs
# of the application. This avoids prompting the user for authorization every
# time the access token expires, by remembering the refresh token.
storage = Storage(CREDENTIAL_STORE_FILE)
credentials = storage.get()

# If no credentials were found, go through the authorization process and
# persist credentials to the credential store.
if credentials is None or credentials.invalid:
  credentials = tools.run_flow(flow, storage,
                               tools.argparser.parse_known_args()[0])

# Use the credentials to authorize an httplib2.Http instance.
http = credentials.authorize(httplib2.Http())

Tạo ứng dụng khách dfareporting được ủy quyền.

# Construct a service object via the discovery service.
service = discovery.build('dfareporting', 'v4', http=http)

Thực hiện thao tác.

# Construct the request.
request = service.userProfiles().list()

# Execute request and print response.
response = request.execute()

for profile in response['items']:
  print('Found user profile with ID %s and user name "%s".' %
        (profile['profileId'], profile['userName']))

Ruby

Tải tệp khóa bí mật của khách hàng và tạo thông tin xác thực ủy quyền.

# Load client ID from the specified file.
client_id = Google::Auth::ClientId.from_file(path_to_json_file)

# Set up the user authorizer.
#
# Note: providing a token store allows auth credentials to be cached, so they
# survive multiple runs of the application. This avoids prompting the user for
# authorization every time the access token expires, by remembering the
# refresh token.
authorizer = Google::Auth::UserAuthorizer.new(
  client_id, [API_NAMESPACE::AUTH_DFAREPORTING], token_store
)

# Authorize and persist credentials to the data store.
#
# Note: the 'user' value below is used to identify a specific set of
# credentials in the token store. You may provide different values here to
# persist credentials for multiple users to the same token store.
authorization = authorizer.get_credentials('user')
if authorization.nil?
  puts format(
    "Open this URL in your browser and authorize the application.\n\n%s" \
    "\n\nEnter the authorization code:",
    authorizer.get_authorization_url(base_url: OAUTH_REDIRECT_URI)
  )
  code = STDIN.gets.chomp
  authorization = authorizer.get_and_store_credentials_from_code(
    base_url: OAUTH_REDIRECT_URI, code: code, user_id: 'user'
  )
end

Tạo ứng dụng khách dfareporting được ủy quyền.

# Create a Dfareporting service object.
#
# Note: application name should be replaced with a value that identifies
# your application. Suggested format is "MyCompany-ProductName".
service = API_NAMESPACE::DfareportingService.new
service.authorization = authorization
service.client_options.application_name = 'Ruby installed app sample'
service.client_options.application_version = '1.0.0'

Thực hiện thao tác.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = service.UserProfiles.List().Execute();

foreach (UserProfile profile in profiles.Items) {
  Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
      profile.ProfileId, profile.UserName);
}

Tìm hiểu thêm

Hãy truy cập vào Tài liệu tham khảo API để tìm hiểu về tất cả các dịch vụ mà API này cung cấp. Mỗi trang chi tiết về phương thức đều có một API Explorer được nhúng để nhúng các yêu cầu kiểm thử trực tiếp từ trình duyệt.

Hãy xem các hướng dẫn khác của chúng tôi về các chủ đề nâng cao và cung cấp ví dụ toàn diện về các thao tác phổ biến.

Khi bạn đã sẵn sàng bắt đầu viết mã, hãy khám phá bộ sưu tập mở rộng gồm các mẫu mã của chúng tôi. Bộ sưu tập này có thể được sửa đổi và mở rộng cho phù hợp với nhu cầu của bạn.