Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai

Campaign Manager 360 API menyediakan akses terprogram ke informasi dari akun Campaign Manager 360 Anda. Digunakan untuk mengelola dan membuat kampanye dan laporan, seperti yang Anda lakukan melalui layanan web Campaign Manager 360 dan Pembuat Laporan.

Panduan ini menjelaskan cara memulai Campaign Manager 360 API.

Prasyarat

Sebelum menggunakan Campaign Manager 360 API, ada beberapa langkah prasyarat yang harus Anda penuhi:

Anda harus memiliki akun Campaign Manager 360. Lihat Pengiklan/Agensi untuk mengetahui informasi pendaftaran.
Akun Campaign Manager 360 Anda harus diaktifkan untuk Akses API. Sebagian besar akun mengaktifkannya secara default; jika Anda tidak yakin, hubungi perwakilan akun atau tim dukungan Campaign Manager 360 untuk mendapatkan bantuan.
Anda harus memiliki profil pengguna yang dapat mengakses akun ini. Minta administrator akun Campaign Manager 360 Anda membuat profil pengguna yang terkait dengan akun ini.
Periksa izin profil pengguna di UI Campaign Manager 360. Ini mengontrol apa saja yang dapat diakses oleh profil pengguna dari API. Tidak ada izin API terpisah.

Membuat project

Untuk mulai menggunakan Campaign Manager 360 API, Anda harus membuat atau memilih project di Konsol API Google dan mengaktifkan API terlebih dahulu. Penggunaan link ini akan memandu Anda melalui proses ini dan mengaktifkan Campaign Manager 360 API secara otomatis.

Mengaktifkan API untuk project yang ada...

Langkah-langkah berikut berlaku bagi pengguna yang sudah memiliki project dan memilih untuk mengaktifkan Campaign Manager 360 API secara manual.

Untuk mengaktifkan API untuk project Anda, lakukan hal berikut:

Buka Library API di Konsol API Google. Jika diminta, pilih project atau buat project baru. Library API menampilkan daftar semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan penelusuran untuk mencarinya.
Pilih API yang ingin Anda aktifkan, lalu klik tombol Enable.
Jika diminta, aktifkan penagihan.
Jika diminta, terima Persyaratan Layanan API.

Membuat kredensial

Semua permintaan yang Anda buat ke Campaign Manager 360 API harus diotorisasi. Untuk ringkasan otorisasi, baca cara memberi otorisasi dan mengidentifikasi aplikasi Anda ke Google.

Petunjuk berikut akan memandu Anda melalui proses pembuatan client ID OAuth 2.0 untuk digunakan dengan alur aplikasi yang terinstal. Untuk petunjuk tentang membuat kredensial penggunaan dengan alur akun layanan, lihat panduan Akun Layanan.

Ikuti langkah-langkah untuk mengonfigurasi project Konsol API Google.
Buka halaman Credentials di Konsol API.
Klik CREATE CREDENTIALS > OAuth client ID.
1. Jika belum mengonfigurasi layar izin OAuth untuk project ini sebelumnya, Anda akan diarahkan untuk melakukannya sekarang. Klik KONFIGURASIKAN LAYAR PESAN.
2. Pilih jenis pengguna, lalu klik BUAT.
3. Isi formulir awal. Anda dapat mengeditnya nanti jika diperlukan. Klik Simpan jika sudah selesai.
4. Buka kembali Credentials > CREATE CREDENTIALs > OAuth client ID untuk melanjutkan.
Pilih Desktop aplikasi sebagai jenis aplikasi, beri nama, lalu klik Buat.

Setelah selesai, Anda akan diberi client ID OAuth 2.0 dan rahasia klien, yang dapat didownload dalam format JSON dan disimpan untuk digunakan nanti.

Mengonfigurasi layar izin pengguna...

Saat Anda menggunakan OAuth 2.0 untuk autentikasi, pengguna Anda diautentikasi setelah menyetujui persyaratan yang ditampilkan kepada mereka di layar izin pengguna.

Untuk menyiapkan layar izin project Anda, lakukan langkah berikut:

Buka halaman Layar Izin di Konsol API Google. Jika diminta, pilih project atau buat project baru.
Isi formulir lalu klik Simpan.

Menginstal library klien

Campaign Manager 360 API dibuat berdasarkan HTTP dan JSON, sehingga semua klien HTTP standar dapat mengirim permintaan ke API ini dan mengurai responsnya.

Namun, library klien Google API menyediakan integrasi bahasa yang lebih baik, keamanan yang lebih baik, dan dukungan untuk membuat permintaan yang diotorisasi. Library klien ini tersedia dalam sejumlah bahasa pemrograman. Dengan menggunakannya, Anda tidak perlu lagi menyetel permintaan HTTP dan mengurai respons secara manual.

Untuk memulai, pilih bahasa pemrograman yang Anda gunakan untuk pengembangan.

C#

Instal library klien Campaign Manager 360 API untuk .NET terbaru. Sebaiknya gunakan NuGet untuk mengelola penginstalan.

Buka Konsol GetGet Package Manager dan jalankan perintah berikut:

Install-Package Google.Apis.Dfareporting.v3_4

Pelajari Lebih Lanjut

Java

Instal library klien Campaign Manager 360 API untuk Java terbaru. Sebaiknya gunakan Maven untuk mengelola penginstalan.

Tambahkan dependensi berikut ke file pom.xml Anda:

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

Pelajari Lebih Lanjut

Pelajari Referensi JavaDoc untuk Campaign Manager 360 API.
Baca panduan developer Google API Client untuk Java.

PHP

Instal library klien Campaign Manager 360 API untuk PHP terbaru. Sebaiknya gunakan Composer untuk mengelola penginstalan Anda.

Buka terminal dan jalankan perintah berikut:

composer require google/apiclient

Jika Anda sudah menginstal library dan hanya ingin mengupdate ke versi terbaru:

composer update google/apiclient

Bergantung pada sistemnya, Anda mungkin perlu mengawali perintah tersebut dengan sudo.

Pelajari Lebih Lanjut

Baca Library Klien Google API untuk panduan developer PHP.

Python

Instal library klien Campaign Manager 360 API untuk Python terbaru. Sebaiknya gunakan pip untuk mengelola penginstalan.

Buka terminal dan jalankan perintah berikut:

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

Bergantung pada sistemnya, Anda mungkin perlu mengawali perintah tersebut dengan sudo.

Pelajari Lebih Lanjut

Pelajari Referensi PyDoc untuk Campaign Manager 360 API.
Baca Library Klien Google API untuk panduan developer Python.

Ruby

Instal library klien Campaign Manager 360 API untuk Ruby terbaru. Sebaiknya gunakan RubyGems untuk mengelola penginstalan.

Buka terminal dan jalankan perintah berikut:

gem install google-api-client

Jika Anda sudah menginstal library dan hanya ingin mengupdate ke versi terbaru:

gem update -y google-api-client

Bergantung pada sistemnya, Anda mungkin perlu mengawali perintah tersebut dengan sudo.

Pelajari Lebih Lanjut

Baca Library Klien Google API untuk panduan developer Ruby.

Bahasa lainnya yang didukung dapat ditemukan di halaman Library Klien.

Buat permintaan

Setelah kredensial OAuth 2.0 dibuat dan library klien diinstal, Anda siap untuk mulai menggunakan Campaign Manager 360 API. Pelajari cara melakukan otorisasi, mengonfigurasi klien, dan membuat permintaan pertama Anda dengan mengikuti panduan memulai di bawah ini.

C#

Muat file rahasia klien dan buat kredensial otorisasi.

Saat pertama kali melakukan langkah ini, Anda akan diminta untuk menerima permintaan otorisasi di browser Anda. Sebelum menyetujui, pastikan Anda login dengan Akun Google yang memiliki akses ke Campaign Manager 360. Aplikasi Anda akan diberi otorisasi untuk mengakses data atas nama akun mana saja yang sedang login.

// 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;

Buat klien Dfareporting yang diotorisasi.

// 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"
    }
);

Jalankan operasi.

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

Muat file rahasia klien dan buat kredensial otorisasi.

// 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");

Buat klien Dfareporting yang diotorisasi.

// 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();

Jalankan operasi.

// 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());
}

PHP

Muat file rahasia klien dan buat kredensial otorisasi.

// 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()));
}

Buat klien Dfareporting yang diotorisasi.

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

Jalankan operasi.

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

Muat file rahasia klien dan buat kredensial otorisasi.

# 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())

Buat klien Dfareporting yang diotorisasi.

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

Jalankan operasi.

# 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

Muat file rahasia klien dan buat kredensial otorisasi.

# 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

Buat klien Dfareporting yang diotorisasi.

# 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'

Jalankan operasi.

// 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);
}

Mempelajari lebih lanjut

Kunjungi Referensi API untuk mempelajari semua layanan yang ditawarkan API. Setiap halaman detail metode memiliki API Explorer sematan yang dapat Anda gunakan untuk membuat permintaan pengujian langsung dari browser.

Tinjau panduan kami yang lain yang membahas topik lanjutan dan memberikan contoh secara menyeluruh untuk tugas umum.

Jika Anda sudah siap untuk mulai menulis kode, jangan ragu untuk menjelajahi koleksi contoh kode kami yang ekstensif, yang dapat dimodifikasi dan diperluas untuk memenuhi kebutuhan Anda.