Per iniziare

C#

Installa la libreria client dell'API Campaign Manager 360 per .NET più recente. Ti consigliamo di utilizzare NuGet per gestire l'installazione.

Apri la console di NuGet Package Manager ed esegui questo comando:

Install-Package Google.Apis.Dfareporting.v3_4

Scopri di più

• Sfoglia la documentazione di riferimento.NET per l'API Campaign Manager 360.
• Leggi la Guida per gli sviluppatori per la libreria client delle API di Google per .NET.

Java

Installa la versione più recente della libreria client dell'API Campaign Manager 360 per Java. Ti consigliamo di utilizzare Maven per gestire l'installazione.

Aggiungi la seguente dipendenza al file 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>

Scopri di più

• Sfoglia la documentazione di riferimento JavaDoc per l'API Campaign Manager 360.
• Leggi la Guida per gli sviluppatori per la libreria client delle API di Google per Java.

PHP

Installa la più recente libreria client dell'API Campaign Manager 360 per PHP. Ti consigliamo di utilizzare Composer per gestire l'installazione.

Apri un terminale ed esegui questo comando:

composer require google/apiclient

Se hai già installato la libreria e vuoi solo eseguire l'aggiornamento all'ultima versione:

composer update google/apiclient

A seconda del sistema, potrebbe essere necessario anteporre a questi comandi sudo.

Scopri di più

• Leggi la Guida per gli sviluppatori per la libreria client delle API di Google per PHP.

Python

Installa la più recente libreria client dell'API Campaign Manager 360 per Python. È consigliabile utilizzare pip per gestire l'installazione.

Apri un terminale ed esegui questo comando:

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

A seconda del sistema, potrebbe essere necessario anteporre a questi comandi sudo.

Scopri di più

• Sfoglia la documentazione di riferimento PyDoc per l'API Campaign Manager 360.
• Leggi la Guida per gli sviluppatori per la libreria client delle API di Google per Python (v1/v2).

Ruby

Installa la più recente libreria client dell'API Campaign Manager 360 per Ruby. Ti consigliamo di utilizzare RubyGems per gestire l'installazione.

Apri un terminale ed esegui questo comando:

gem install google-api-client

Se hai già installato la libreria e vuoi solo eseguire l'aggiornamento all'ultima versione:

gem update -y google-api-client

A seconda del sistema, potrebbe essere necessario anteporre a questi comandi sudo.

Scopri di più

• Leggi la Guida per gli sviluppatori per la libreria client delle API di Google per Ruby.

C#

1. Carica il file client secret e genera le credenziali di autorizzazione.

   La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Campaign Manager 360. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

   // 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. Crea un client Dfareporting autorizzato.

   // 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. Esegui un'operazione.

   // 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. Carica il file client secret e genera le credenziali di autorizzazione.

   La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Campaign Manager 360. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

   // 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. Crea un client Dfareporting autorizzato.

   // 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. Esegui un'operazione.

   // 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. Carica il file client secret e genera le credenziali di autorizzazione.

   La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Campaign Manager 360. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

   // 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. Crea un client Dfareporting autorizzato.

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

3. Esegui un'operazione.

   // 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. Carica il file client secret e genera le credenziali di autorizzazione.

   La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Campaign Manager 360. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

   # 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. Crea un client Dfareporting autorizzato.

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

3. Esegui un'operazione.

   # 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. Carica il file client secret e genera le credenziali di autorizzazione.

   La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Campaign Manager 360. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

   # 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. Crea un client Dfareporting autorizzato.

   # 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. Esegui un'operazione.

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