شروع به کار

سی شارپ

آخرین نسخه کتابخانه کلاینت Campaign Manager 360 API برای .NET را نصب کنید. استفاده از NuGet برای مدیریت نصب توصیه می‌شود.

کنسول NuGet Package Manager را باز کنید و دستور زیر را اجرا کنید:

Install-Package Google.Apis.Dfareporting.v3_4

اطلاعات بیشتر

• برای API مربوط به Campaign Manager 360، به مستندات مرجع .NET مراجعه کنید.
• برای راهنمای توسعه‌دهندگان .NET، کتابخانه کلاینت API گوگل را مطالعه کنید.

جاوا

آخرین نسخه کتابخانه کلاینت Campaign Manager 360 API برای جاوا را نصب کنید. استفاده از 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>

اطلاعات بیشتر

• برای API مربوط به Campaign Manager 360 به مرجع JavaDoc مراجعه کنید.
• برای راهنمای توسعه‌دهندگان جاوا، کتابخانه کلاینت API گوگل را مطالعه کنید.

پی اچ پی

آخرین نسخه کتابخانه کلاینت Campaign Manager 360 API را برای PHP نصب کنید. استفاده از Composer برای مدیریت نصب توصیه می‌شود.

یک ترمینال باز کنید و دستور زیر را اجرا کنید:

composer require google/apiclient

اگر قبلاً کتابخانه را نصب کرده‌اید و فقط می‌خواهید آن را به آخرین نسخه به‌روزرسانی کنید:

composer update google/apiclient

بسته به سیستم شما، ممکن است لازم باشد این دستورات را با sudo شروع کنید.

اطلاعات بیشتر

• برای راهنمای توسعه‌دهندگان PHP، کتابخانه کلاینت API گوگل را مطالعه کنید.

پایتون

آخرین نسخه کتابخانه کلاینت Campaign Manager 360 API برای پایتون را نصب کنید. استفاده از pip برای مدیریت نصب توصیه می‌شود.

یک ترمینال باز کنید و دستور زیر را اجرا کنید:

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

بسته به سیستم شما، ممکن است لازم باشد این دستورات را با sudo شروع کنید.

اطلاعات بیشتر

• برای API مربوط به Campaign Manager 360 به مرجع PyDoc مراجعه کنید.
• راهنمای توسعه‌دهندگان کتابخانه کلاینت API گوگل برای پایتون (نسخه ۱/۲) را مطالعه کنید.

روبی

آخرین نسخه کتابخانه کلاینت Campaign Manager 360 API را برای Ruby نصب کنید. استفاده از RubyGems برای مدیریت نصب توصیه می‌شود.

یک ترمینال باز کنید و دستور زیر را اجرا کنید:

gem install google-api-client

اگر قبلاً کتابخانه را نصب کرده‌اید و فقط می‌خواهید آن را به آخرین نسخه به‌روزرسانی کنید:

gem update -y google-api-client

بسته به سیستم شما، ممکن است لازم باشد این دستورات را با sudo شروع کنید.

اطلاعات بیشتر

• برای راهنمای توسعه‌دهندگان روبی، کتابخانه کلاینت API گوگل را مطالعه کنید.

سی شارپ

1. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به 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);
   }

جاوا

1. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به 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());
   }

پی اچ پی

1. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به 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()
       );
   }

پایتون

1. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به 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. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به 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);
   }