Başlama

Campaign Manager 360 API, Campaign Manager 360 hesabı. Kampanyaları ve raporları yönetmek, oluşturmak, Tıpkı Campaign Manager 360 ve Rapor Oluşturucu web hizmetlerinde olduğu gibi.

Bu kılavuzda, Campaign Manager 360 API'yi kullanmaya nasıl başlayacağınız açıklanmaktadır.

Ön koşullar

Campaign Manager 360 API'sini kullanmadan önce uygulamanız gereken birkaç ön koşul vardır. karşılayın:

  1. Campaign Manager 360 hesabınızın olması gerekir. Görüntüleyin Kayıt bilgileri için Reklamverenler/Ajanslar.

  2. Campaign Manager 360 hesabınız, API Erişimi için etkinleştirilmelidir. En sık Bu özellik hesaplarda varsayılan olarak etkindir; Emin değilseniz hesap temsilcisi veya Campaign Manager 360 ekibine ulaşın.

  3. Bu hesaba erişimi olan bir kullanıcı profilinizin olması gerekir. Campaign Manager 360 hesap yöneticisi, bu hesabı kullanabilirsiniz.

  4. Campaign Manager 360 kullanıcı arayüzünde kullanıcı profili izinlerini kontrol edin. Bu kontroller, Kullanıcı profilinin API'den nelere erişebileceği. Ayrı bir API yoktur. izin verir.

Proje oluşturma

Campaign Manager 360 API'sini kullanmaya başlamak için önce veya Google API Konsolu'nda bir proje seçin ve API'yi etkinleştirin. Bunu kullanma bağlantısı, işlem boyunca size yol gösterir ve Campaign Manager 360 API'yi etkinleştirir otomatik olarak oluşturur.

Kimlik bilgisi oluştur

Campaign Manager 360 API'ye gönderdiğiniz tüm istekler yetkilendirilmelidir. Özet için yetkilendirmeye genel bakış, Google Hesabınızı nasıl yetkilendireceğiniz ve Google'a Uygulama.

Aşağıdaki talimatlar OAuth oluşturma sürecinde size yol gösterir Yüklü uygulamayla kullanılacak 2.0 istemci kimliği akışı ile ilgili daha fazla bilgi edinin. Kullanılacak kimlik bilgisi oluşturma talimatları için hakkında daha fazla bilgi edinmek için Hizmet Hesapları rehberini inceleyin.

  1. Bir Google API Konsolu projesini yapılandırma adımlarını uygulayın.

  2. API Konsolu'nda Kimlik Bilgileri sayfasını açın.

  3. KİMLİK BİLGİLERİ OLUŞTUR > OAuth istemci kimliği.

    1. Bu proje için OAuth izin ekranı yapılandırmadıysanız önceden şimdi buna yönlendirileceksiniz. İZNİ YAPILANDIR'ı tıklayın. SCREEN seçeneğini belirleyin.

    2. Kullanıcı türünü seçin ve OLUŞTUR'u tıklayın.

    3. İlk formu doldurun. Gerekirse bunu daha sonra düzenleyebilirsiniz. Sonraki slayta geçin İşlem tamamlandığında kaydedin.

    4. Kimlik bilgileri > KİMLİK BİLGİLERİ OLUŞTURUN > OAuth istemci kimliği devam.

  4. Uygulama türü olarak Masaüstü uygulaması'nı seçin, bir ad verin ve ardından Oluştur.

İşlem tamamlandığında size bir OAuth 2.0 istemci kimliği ve istemci sunulacak gizli anahtarı kullanabilirsiniz. Bu gizli anahtarı JSON biçiminde indirip daha sonra kullanmak üzere kaydedebilirsiniz.

İstemci kitaplığı yükleme

Campaign Manager 360 API, HTTP ve JSON üzerine kurulu olduğundan herhangi bir standart HTTP istemcisi isteklerini geri alır ve yanıtları ayrıştırır.

Ancak Google API istemci kitaplıkları daha iyi dil entegrasyonu sağlar. daha fazla güvenlik ve yetkilendirilmiş isteklerde bulunma desteği. Müşteri kütüphaneler çeşitli programlama dillerinde mevcuttur; bunları kullanarak sayesinde HTTP isteklerini manuel olarak oluşturma ve yanıtları ayrıştırma ihtiyacını ortadan kaldırabilirsiniz.

Başlamak için kullandığınız programlama dilini seçin bahsedeceğim.

C#

.NET için Campaign Manager 360 API istemci kitaplığının en son sürümünü yükleyin. Kullanım Yüklemenizi yönetmek için NuGet önerilir.

NuGet Package Manager Konsolu'nu açın ve aşağıdaki komutu çalıştırın:

Install-Package Google.Apis.Dfareporting.v3_4

Daha Fazla Bilgi

Java

Java için en güncel Campaign Manager 360 API istemci kitaplığını yükleyin. Kullanım Yüklemenizi yönetmek için Maven önerilir.

pom.xml dosyanıza şu bağımlılığı ekleyin:

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

Daha Fazla Bilgi

PHP

PHP için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Kullanım Yüklemenizi yönetmek için Composer önerilir.

Bir terminal penceresi açın ve aşağıdaki komutu çalıştırın:

composer require google/apiclient

Kitaplığı zaten yüklediyseniz ve en son sürüm:

composer update google/apiclient

Sisteminize bağlı olarak, bu komutların başına sudo

Daha Fazla Bilgi

Python

Python için Campaign Manager 360 API istemci kitaplığının en son sürümünü yükleyin. Kullanım pip kullanmanızı öneririz.

Bir terminal penceresi açın ve aşağıdaki komutu çalıştırın:

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

Sisteminize bağlı olarak, bu komutların başına sudo

Daha Fazla Bilgi

Ruby

Ruby için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Kullanım Yüklemenizi yönetmek için RubyGems önerilir.

Bir terminal penceresi açın ve aşağıdaki komutu çalıştırın:

gem install google-api-client

Kitaplığı zaten yüklediyseniz ve en son sürüm:

gem update -y google-api-client

Sisteminize bağlı olarak, bu komutların başına sudo

Daha Fazla Bilgi

Desteklenen diğer diller İstemcide Kitaplıklar sayfası.

İstekte bulunun

OAuth 2.0 kimlik bilgileri oluşturuldu ve istemci kitaplığı ile yüklediğinizde Campaign Manager 360 API'sini kullanmaya hazır olursunuz. Nasıl yapacağınızı öğrenin ve aşağıdaki adımları uygulayarak ilk kez istekte bulunabilirsiniz: aşağıdaki hızlı başlangıç kılavuzundan yararlanabilirsiniz.

C#

  1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce, Campaign Manager 360'a erişimi olan bir Google Hesabı ile giriş yaptığınızdan emin olun. Uygulamanız, şu anda giriş yapılmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

  2. Yetkili bir Dfareporting istemcisi oluşturun.

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

  3. Bir işlem gerçekleştirin.

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

  1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce, Campaign Manager 360'a erişimi olan bir Google Hesabı ile giriş yaptığınızdan emin olun. Uygulamanız, şu anda giriş yapılmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

  2. Yetkili bir Dfareporting istemcisi oluşturun.

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

  3. Bir işlem gerçekleştirin.

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

  1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce, Campaign Manager 360'a erişimi olan bir Google Hesabı ile giriş yaptığınızdan emin olun. Uygulamanız, şu anda giriş yapılmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

  2. Yetkili bir Dfareporting istemcisi oluşturun.

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

  3. Bir işlem gerçekleştirin.

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

  1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce, Campaign Manager 360'a erişimi olan bir Google Hesabı ile giriş yaptığınızdan emin olun. Uygulamanız, şu anda giriş yapılmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

  2. Yetkili bir Dfareporting istemcisi oluşturun.

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

  3. Bir işlem gerçekleştirin.

    # 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

  1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce, Campaign Manager 360'a erişimi olan bir Google Hesabı ile giriş yaptığınızdan emin olun. Uygulamanız, şu anda giriş yapılmış olan hesap adına verilere erişme yetkisine sahip olur. 

    # 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

  2. Yetkili bir Dfareporting istemcisi oluşturun.

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

  3. Bir işlem gerçekleştirin.

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

Daha fazla bilgi

API Referansı'nı ziyaret ederek özellikleri. Her yöntem ayrıntısı sayfası yerleşik bir API'ye sahiptir Gezgin kullanarak doğrudan emin olun.

İleri düzey konuları kapsayan ve baştan sona ayrıntılı bilgiler sunan diğer kılavuzlarımızı inceleyin örnek olarak verilebilir.

Kod yazmaya hazır olduğunuzda, Google Cloud Yardım Merkezi'ndeki kod örneklerinden oluşan bir koleksiyon, ihtiyaçlarınıza uygun şekilde genişletildi.