Başlama

Campaign Manager 360 API, Campaign Manager 360 hesabınızdaki bilgilere programatik erişim sağlar. Tıpkı Campaign Manager 360 ve Rapor Oluşturucu web hizmetleri üzerinden yaptığınız gibi kampanyaları ve raporları yönetmek ve oluşturmak için kullanılır.

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'yi kullanmadan önce uygulamanız gereken birkaç ön koşul adım vardır:

  1. Campaign Manager 360 hesabınız olmalıdır. Kaydolma bilgileri için Reklamverenler/Ajanslar bölümüne bakın.

  2. Campaign Manager 360 hesabınız API erişimi için etkinleştirilmiş olmalıdır. Bu özellik çoğu hesapta varsayılan olarak etkindir. Emin değilseniz yardım için hesap temsilcinizle veya Campaign Manager 360 destek ekibiyle iletişime geçin.

  3. Bu hesaba erişimi olan bir kullanıcı profiliniz olmalıdır. Campaign Manager 360 hesap yöneticinizden bu hesapla ilişkili bir kullanıcı profili oluşturmasını isteyin.

  4. Campaign Manager 360 kullanıcı arayüzünde kullanıcı profili izinlerini kontrol edin. Bunlar, kullanıcı profilinin API'den erişebileceği öğeleri kontrol eder. Ayrı API izinleri yoktur.

Proje oluşturma

Campaign Manager 360 API'yi kullanmaya başlamak için önce Google API Konsolu'nda bir proje oluşturmanız veya seçmeniz ve API'yi etkinleştirmeniz gerekir. Bu bağlantıyı kullanarak işlem boyunca size yol gösterilir ve Campaign Manager 360 API otomatik olarak etkinleştirilir.

Aşağıdaki adımlar, mevcut bir projesi olan ve Campaign Manager 360 API'yi proje için manuel olarak etkinleştirmeyi tercih eden kullanıcılar için geçerlidir.

Projeniz için bir API'yi etkinleştirmek üzere şunları yapın:

  1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse bir proje seçin veya yeni proje oluşturun. API Kitaplığı, mevcut tüm API'leri ürün ailesine ve popülerliğe göre gruplandırarak listeler.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa arama yaparak bulabilirsiniz.
  3. Etkinleştirmek istediğiniz API'yi seçin, ardından Etkinleştir düğmesini tıklayın.
  4. İstenirse faturalandırmayı etkinleştirin.
  5. İstenirse API'nin Hizmet Şartları'nı kabul edin.

Kimlik bilgisi oluşturma

Campaign Manager 360 API'sine gönderdiğiniz tüm istekler yetkilendirilmelidir. Yetkilendirmeye kısaca göz atmak için Google'a uygulamanızı yetkilendirme ve tanımlama hakkındaki makaleyi inceleyin.

Aşağıdaki talimatlar, yüklü uygulama akışıyla kullanılacak bir OAuth 2.0 istemci kimliği oluşturma sürecinde size yol gösterecektir. Hizmet hesabı akışıyla birlikte kullanılacak kimlik bilgilerini oluşturma talimatları için Hizmet Hesapları kılavuzunu inceleyin.

  1. 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İĞİ BİLGİLERİ OLUŞTUR > OAuth istemci kimliği'ni tıklayın.

    1. Bu proje için daha önce bir OAuth izin ekranı yapılandırmadıysanız bunu hemen yapmanız istenir. İZİN EKRANINI YAPILANDIR'ı tıklayın.

    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. İşlemi tamamladığınızda Kaydet'i tıklayın.

    4. Devam etmek için Kimlik bilgileri > KİMLİK BİLGİLERİ OLUŞTUR > OAuth istemci kimliği'ne geri dönün.

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

İşlem tamamlandığında, OAuth 2.0 istemci kimliği ve istemci gizlisi gösterilir. Bunları JSON biçiminde indirip daha sonra kullanmak üzere kaydedebilirsiniz.

Kimlik doğrulama için OAuth 2.0 kullandığınızda kullanıcılarınızın kimliği, kullanıcı izin ekranında kendilerine sunulan şartları kabul ettikten sonra doğrulanır.

Projenizin izin ekranını ayarlamak için aşağıdakileri yapın:

  1. Google API Konsolu'nda İzin Ekranı sayfasını açın. İstenirse bir proje seçin veya yeni bir proje oluşturun.
  2. Formu doldurup Kaydet'i tıklayın.

İstemci kitaplığı yükleme

Campaign Manager 360 API'si HTTP ve JSON üzerine kurulu olduğundan herhangi bir standart HTTP istemcisi ona istek gönderebilir ve yanıtları ayrıştırabilir.

Ancak Google API istemci kitaplıkları daha iyi dil entegrasyonu ve daha yüksek güvenlik sağlamanın yanı sıra yetkili isteklerin yapılmasını da destekler. İstemci kitaplıkları çeşitli programlama dillerinde kullanılabilir; bunları kullanarak HTTP isteklerini manuel olarak oluşturma ve yanıtları ayrıştırma zahmetinden kurtulabilirsiniz.

Başlamak için geliştirmede kullandığınız programlama dilini seçin.

C#JavaPHPPythonRuby

.NET için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Yükleme işleminizi yönetmek için NuGet'i kullanmanız önerilir.

NuGet Paket Yöneticisi Konsolu'nu açıp aşağıdaki komutu çalıştırın:

Install-Package Google.Apis.Dfareporting.v3_4

Daha Fazla Bilgi

Java için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Yüklemenizi yönetmek için Maven kullanılması önerilir.

pom.xml dosyanıza aşağıdaki 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 için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Kurulumunuzu yönetmek için Composer'ı kullanmanız önerilir.

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

composer require google/apiclient

Kitaplığı zaten yüklediyseniz ve yalnızca en son sürüme güncellemek istiyorsanız:

composer update google/apiclient

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

Daha Fazla Bilgi

Python için en son Campaign Manager 360 API istemci kitaplığını yükleyin. Yüklemenizi yönetmek için pip kullanılması önerilir.

Bir terminal açıp 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 eklemeniz gerekebilir.

Daha Fazla Bilgi

En son Ruby için Campaign Manager 360 API istemci kitaplığını yükleyin. Yüklemenizi yönetmek için RubyGems'i kullanmanız önerilir.

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

gem install google-api-client

Kitaplığı zaten yüklediyseniz ve yalnızca en son sürüme güncellemek istiyorsanız:

gem update -y google-api-client

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

Daha Fazla Bilgi

Desteklenen diğer dilleri İstemci Kitaplıkları sayfasında bulabilirsiniz.

İstekte bulunun

OAuth 2.0 kimlik bilgileri oluşturulduktan ve istemci kitaplığı yüklendikten sonra Campaign Manager 360 API'yi kullanmaya hazırsınız demektir. Aşağıdaki hızlı başlangıç kılavuzunu uygulayarak nasıl yetkilendireceğinizi, istemcinizi nasıl yapılandıracağınızı ve ilk isteğinizi nasıl göndereceğinizi öğrenin.

C#JavaPHPPythonRuby

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

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

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

  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']))

  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'nin sunduğu tüm hizmetler hakkında bilgi edinmek için API Referansı'nı ziyaret edin. Her yöntem ayrıntıları sayfasında, doğrudan tarayıcınızdan test istekleri göndermek için kullanabileceğiniz yerleşik bir API Explorer bulunur.

Gelişmiş konuları ele alan ve sık kullanılan görevler için uçtan uca örnekler sunan diğer kılavuzlarımızı inceleyin.

Kod yazmaya başlamaya hazır olduğunuzda, ihtiyaçlarınıza göre değiştirilip genişletilebilir kapsamlı kod örnekleri koleksiyonumuzu keşfedebilirsiniz.