Начать

C#

Установите последнюю версию клиентской библиотеки API Campaign Manager 360 для .NET . Рекомендуется использовать NuGet для управления установкой.

Откройте консоль диспетчера пакетов NuGet и выполните следующую команду:

Install-Package Google.Apis.Dfareporting.v3_4

Узнать больше

• Ознакомьтесь с документацией по API Campaign Manager 360 в среде .NET .
• Ознакомьтесь с руководством разработчика по библиотеке Google API Client Library для .NET .

Java

Установите последнюю версию клиентской библиотеки API Campaign Manager 360 для Java . Рекомендуется использовать Maven для управления установкой.

Добавьте следующую зависимость в ваш файл pom.xml :

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

Узнать больше

• Ознакомьтесь со справочником JavaDoc по API Campaign Manager 360 .
• Ознакомьтесь с руководством для разработчиков по библиотеке Google API Client Library for Java .

PHP

Установите последнюю версию клиентской библиотеки Campaign Manager 360 API для PHP . Рекомендуется использовать Composer для управления установкой.

Откройте терминал и выполните следующую команду:

composer require google/apiclient

Если вы уже установили библиотеку и просто хотите обновить её до последней версии:

composer update google/apiclient

В зависимости от вашей системы, возможно, потребуется добавить перед этими командами префикс sudo .

Узнать больше

• Ознакомьтесь с руководством для разработчиков по библиотеке Google API Client Library for PHP .

Python

Установите последнюю версию клиентской библиотеки API Campaign Manager 360 для Python . Рекомендуется использовать pip для управления установкой.

Откройте терминал и выполните следующую команду:

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

В зависимости от вашей системы, возможно, потребуется добавить перед этими командами префикс sudo .

Узнать больше

• Ознакомьтесь со справочником PyDoc по API Campaign Manager 360 .
• Ознакомьтесь с руководством разработчика по библиотеке Google API Client Library для Python (версии 1/2) .

Руби

Установите последнюю версию клиентской библиотеки API Campaign Manager 360 для Ruby . Рекомендуется использовать RubyGems для управления установкой.

Откройте терминал и выполните следующую команду:

gem install google-api-client

Если вы уже установили библиотеку и просто хотите обновить её до последней версии:

gem update -y google-api-client

В зависимости от вашей системы, возможно, потребуется добавить перед этими командами префикс sudo .

Узнать больше

• Ознакомьтесь с руководством разработчика по библиотеке Google API Client Library для Ruby .

C#

1. Загрузите файл с секретами клиента и сгенерируйте учетные данные для авторизации.

   При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в вашем браузере. Прежде чем принять его, убедитесь, что вы вошли в систему с учетной записью Google, имеющей доступ к Campaign Manager 360. Ваше приложение будет авторизовано для доступа к данным от имени той учетной записи, которая в данный момент авторизована.

   // 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. Создайте авторизованный клиент Dfareporting.

   // 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. Выполнить операцию.

   // 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. Загрузите файл с секретами клиента и сгенерируйте учетные данные для авторизации.

   При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в вашем браузере. Прежде чем принять его, убедитесь, что вы вошли в систему с учетной записью Google, имеющей доступ к Campaign Manager 360. Ваше приложение будет авторизовано для доступа к данным от имени той учетной записи, которая в данный момент авторизована.

   // 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. Создайте авторизованный клиент Dfareporting.

   // 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. Выполнить операцию.

   // 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. Загрузите файл с секретами клиента и сгенерируйте учетные данные для авторизации.

   При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в вашем браузере. Прежде чем принять его, убедитесь, что вы вошли в систему с учетной записью Google, имеющей доступ к Campaign Manager 360. Ваше приложение будет авторизовано для доступа к данным от имени той учетной записи, которая в данный момент авторизована.

   // 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. Создайте авторизованный клиент Dfareporting.

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

3. Выполнить операцию.

   // 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. Загрузите файл с секретами клиента и сгенерируйте учетные данные для авторизации.

   При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в вашем браузере. Прежде чем принять его, убедитесь, что вы вошли в систему с учетной записью Google, имеющей доступ к Campaign Manager 360. Ваше приложение будет авторизовано для доступа к данным от имени той учетной записи, которая в данный момент авторизована.

   # 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. Создайте авторизованный клиент Dfareporting.

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

3. Выполнить операцию.

   # 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. Загрузите файл с секретами клиента и сгенерируйте учетные данные для авторизации.

   При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в вашем браузере. Прежде чем принять его, убедитесь, что вы вошли в систему с учетной записью Google, имеющей доступ к Campaign Manager 360. Ваше приложение будет авторизовано для доступа к данным от имени той учетной записи, которая в данный момент авторизована.

   # 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. Создайте авторизованный клиент Dfareporting.

   # 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. Выполнить операцию.

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