Começar

C#

Instale a versão mais recente da biblioteca de cliente da API Campaign Manager 360 para .NET. Usando O NuGet (em inglês) para gerenciar a instalação é recomendado.

Abra o NuGet Package Manager Console e execute o seguinte comando:

Install-Package Google.Apis.Dfareporting.v3_4

Saiba mais

• Confira a documentação de referência do.NET para a API Campaign Manager 360.
• Leia o guia do desenvolvedor da biblioteca de cliente da API do Google para .NET.

Java

Instale a versão mais recente da biblioteca de cliente da API Campaign Manager 360 para Java. Usando É recomendável usar o Maven para gerenciar a instalação.

Adicione a dependência abaixo ao arquivo 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>

Saiba mais

• Consulte a referência do JavaDoc para a API Campaign Manager 360.
• Leia o guia do desenvolvedor da biblioteca de cliente da API do Google para Java.

PHP

Instale a versão mais recente da biblioteca de cliente da API Campaign Manager 360 para PHP. Usando O Composer (em inglês) para gerenciar a instalação é recomendado.

Abra um terminal e execute o seguinte comando:

composer require google/apiclient

Se você já instalou a biblioteca e quer apenas atualizar para a versão mais recente:

composer update google/apiclient

Dependendo do sistema, talvez seja necessário anexar esses comandos ao início sudo:

Saiba mais

• Leia o guia do desenvolvedor da biblioteca de cliente da API do Google para PHP.

Python

Instale a versão mais recente da biblioteca de cliente da API Campaign Manager 360 para Python. Usando pip para gerenciar a instalação.

Abra um terminal e execute o seguinte comando:

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

Dependendo do sistema, talvez seja necessário anexar esses comandos ao início sudo:

Saiba mais

• Consulte a referência de PyDoc para a API Campaign Manager 360.
• Leia o guia do desenvolvedor da biblioteca de cliente da API do Google para Python.

Ruby

Instale a versão mais recente da biblioteca de cliente da API Campaign Manager 360 para Ruby. Usando Recomendamos o RubyGems para gerenciar a instalação.

Abra um terminal e execute o seguinte comando:

gem install google-api-client

Se você já instalou a biblioteca e quer apenas atualizar para a versão mais recente:

gem update -y google-api-client

Dependendo do sistema, talvez seja necessário anexar esses comandos ao início sudo:

Saiba mais

• Leia o guia do desenvolvedor da biblioteca de cliente da API do Google para Ruby.

C#

1. Carregue o arquivo da chave secreta do cliente e gere credenciais de autorização.

   Ao realizar essa etapa pela primeira vez, será solicitado que você aceite um prompt de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso ao Campaign Manager 360. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que esteja conectada no momento.

   // 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. Criar um cliente Dfareporting autorizado.

   // 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. Execute uma operação.

   // 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. Carregue o arquivo da chave secreta do cliente e gere credenciais de autorização.

   Ao realizar essa etapa pela primeira vez, será solicitado que você aceite um prompt de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso ao Campaign Manager 360. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que esteja conectada no momento.

   // 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. Criar um cliente Dfareporting autorizado.

   // 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. Execute uma operação.

   // 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. Carregue o arquivo da chave secreta do cliente e gere credenciais de autorização.

   Ao realizar essa etapa pela primeira vez, será solicitado que você aceite um prompt de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso ao Campaign Manager 360. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que esteja conectada no momento.

   // 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. Criar um cliente Dfareporting autorizado.

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

3. Execute uma operação.

   // 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. Carregue o arquivo da chave secreta do cliente e gere credenciais de autorização.

   Ao realizar essa etapa pela primeira vez, será solicitado que você aceite um prompt de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso ao Campaign Manager 360. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que esteja conectada no momento.

   # 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. Criar um cliente Dfareporting autorizado.

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

3. Execute uma operação.

   # 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. Carregue o arquivo da chave secreta do cliente e gere credenciais de autorização.

   Ao realizar essa etapa pela primeira vez, será solicitado que você aceite um prompt de autorização no navegador. Antes de aceitar, verifique se você fez login com uma Conta do Google que tenha acesso ao Campaign Manager 360. Seu aplicativo será autorizado a acessar dados em nome de qualquer conta que esteja conectada no momento.

   # 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. Criar um cliente Dfareporting autorizado.

   # 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. Execute uma operação.

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