इस पेज का अनुवाद Cloud Translation API से किया गया है.

शुरू करें

Campaign Manager 360 API में, आपके Campaign Manager 360 खाते की जानकारी को प्रोग्राम के हिसाब से ऐक्सेस किया जाता है. इसका इस्तेमाल, कैंपेन और रिपोर्ट को मैनेज करने और बनाने में भी किया जाता है, जैसे कि Campaign Manager 360 और रिपोर्ट बिल्डर की वेब सेवाओं से किया जाता है.

इस गाइड में Campaign Manager 360 एपीआई को इस्तेमाल करने का तरीका बताया गया है.

ज़रूरी शर्तें

Campaign Manager 360 एपीआई का इस्तेमाल करने से पहले, आपको कुछ ज़रूरी शर्तों को पूरा करना होगा:

आपके पास Campaign Manager 360 खाता होना चाहिए. साइनअप की जानकारी के लिए, विज्ञापन देने वाले/एजेंसी देखें.
आपका Campaign Manager 360 खाता, एपीआई ऐक्सेस के लिए चालू होना चाहिए. ज़्यादातर खातों में डिफ़ॉल्ट रूप से चालू होती है. अगर आपको पक्के तौर पर नहीं पता है, तो अपने खाता प्रतिनिधि या सहायता के लिए Campaign Manager 360 की सहायता टीम से संपर्क करें.
आपके पास इस खाते का ऐक्सेस वाला एक उपयोगकर्ता प्रोफ़ाइल होना चाहिए. Campaign Manager 360 खाते के एडमिन को इस खाते से जुड़ी उपयोगकर्ता प्रोफ़ाइल बनाने के लिए कहें.
Campaign Manager 360 के यूज़र इंटरफ़ेस (यूआई) में उपयोगकर्ता की प्रोफ़ाइल की अनुमतियां देखें. इन कंट्रोल की मदद से यह तय किया जा सकता है कि उपयोगकर्ता किस प्रोफ़ाइल से एपीआई ऐक्सेस कर सकता है. कोई अलग एपीआई अनुमति नहीं है.

प्रोजेक्ट बनाना

Campaign Manager 360 एपीआई का इस्तेमाल शुरू करने के लिए, पहले आपको Google API कंसोल में कोई प्रोजेक्ट बनाना या चुनना होगा और एपीआई को चालू करना होगा. इस लिंक का इस्तेमाल करने से आपको इस प्रोसेस में मदद मिलती है. साथ ही, Campaign Manager 360 एपीआई अपने-आप चालू हो जाता है.

किसी मौजूदा प्रोजेक्ट के लिए एपीआई चालू करना...

नीचे दिए गए तरीके उन उपयोगकर्ताओं पर लागू होते हैं जिनके पास कोई मौजूदा प्रोजेक्ट है. साथ ही, वे Campaign Manager 360 API को मैन्युअल तरीके से चालू करना चाहते हैं.

अपने प्रोजेक्ट के लिए एपीआई चालू करने के लिए, ये करें:

Google API (एपीआई) कंसोल में एपीआई लाइब्रेरी खोलें. पूछे जाने पर, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में उपलब्ध सभी एपीआई की सूची होती है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप किया जाता है.
आप जिस एपीआई को चालू करना चाहते हैं वह सूची में नहीं दिख रहा है, तो उसे ढूंढने के लिए खोज का इस्तेमाल करें.
वह एपीआई चुनें जिसे चालू करना है. इसके बाद, चालू करें बटन पर क्लिक करें.
कहे जाने पर, बिलिंग चालू करें.
अनुरोध किए जाने पर, एपीआई की सेवा की शर्तें स्वीकार करें.

क्रेडेंशियल जनरेट करें

Campaign Manager 360 एपीआई को भेजे जाने वाले सभी अनुरोधों को अनुमति देना ज़रूरी है. अनुमति देने से जुड़ी खास जानकारी के लिए, Google को अपने ऐप्लिकेशन की अनुमति देने और उसकी पहचान करने का तरीका जानें.

नीचे दिए गए निर्देशों में, इंस्टॉल किए गए ऐप्लिकेशन के साथ इस्तेमाल करने के लिए, OAuth 2.0 क्लाइंट आईडी बनाने की प्रोसेस बताई गई है. सेवा खाता फ़्लो के साथ इस्तेमाल करने के लिए क्रेडेंशियल जनरेट करने से जुड़े निर्देशों के लिए, सेवा खाते की गाइड देखें.

Google API (एपीआई) कंसोल प्रोजेक्ट को कॉन्फ़िगर करने का तरीका अपनाएं.
एपीआई कंसोल में क्रेडेंशियल पेज खोलें.
Create CREDENTIALS > OAuth क्लाइंट आईडी पर क्लिक करें.
1. अगर आपने पहले इस प्रोजेक्ट के लिए OAuth सहमति स्क्रीन कॉन्फ़िगर नहीं की थी, तो अब आपको ऐसा करने के लिए कहा जाएगा. कॉन्फ़िगरेशन कॉन्फ़िगर करें स्क्रीन पर क्लिक करें.
2. उपयोगकर्ता टाइप चुनें और बनाएं पर क्लिक करें.
3. शुरुआती फ़ॉर्म भरें. ज़रूरत पड़ने पर, इसमें बदलाव किया जा सकता है. आखिर में, सेव करें पर क्लिक करें.
4. जारी रखने के लिए, क्रेडेंशियल > CREATE CREDENTIALS > OAuth क्लाइंट आईडी पर वापस जाएं.
ऐप्लिकेशन प्रकार के रूप में डेस्कटॉप ऐप्लिकेशन चुनें और उसे एक नाम दें. इसके बाद बनाएं पर क्लिक करें.

प्रोसेस पूरी होने पर, आपको OAuth 2.0 क्लाइंट आईडी और क्लाइंट सीक्रेट दिया जाएगा. इसे JSON फ़ॉर्मैट में डाउनलोड किया जा सकता है और बाद में इस्तेमाल करने के लिए सेव किया जा सकता है.

उपयोगकर्ता की सहमति वाली स्क्रीन को कॉन्फ़िगर किया जा रहा है...

जब पुष्टि करने के लिए OAuth 2.0 का इस्तेमाल किया जाता है, तो उपयोगकर्ताओं की पुष्टि हो जाती है. इसके लिए, उन्हें उपयोगकर्ता की सहमति वाली स्क्रीन पर दिखाई गई शर्तों से सहमत होना होता है.

अपने प्रोजेक्ट की सहमति वाली स्क्रीन सेट अप करने के लिए, ये काम करें:

Google API (एपीआई) कंसोल में सहमति स्क्रीन पेज खोलें. पूछे जाने पर, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
फ़ॉर्म भरें और सेव करें पर क्लिक करें.

क्लाइंट लाइब्रेरी इंस्टॉल करना

Campaign Manager 360 API को एचटीटीपी और JSON पर बनाया गया है. इसलिए, कोई भी स्टैंडर्ड एचटीटीपी क्लाइंट इसके लिए अनुरोध भेज सकता है और जवाबों को पार्स कर सकता है.

हालांकि, Google API क्लाइंट लाइब्रेरी की मदद से, भाषा का बेहतर इंटिग्रेशन, बेहतर सुरक्षा, और अनुमति वाले अनुरोध करने में मदद मिलती है. क्लाइंट लाइब्रेरी कई प्रोग्रामिंग भाषाओं में उपलब्ध हैं. इनका इस्तेमाल करके, एचटीटीपी अनुरोधों को मैन्युअल तरीके से सेट अप करने और जवाबों को पार्स करने से बचा जा सकता है.

शुरू करने के लिए, उस प्रोग्रामिंग भाषा को चुनें जिसका इस्तेमाल डेवलपमेंट के लिए किया जा रहा है.

C#

.NET के लिए सबसे नए Campaign Manager 360 API क्लाइंट लाइब्रेरी को इंस्टॉल करें. हमारा सुझाव है कि आप अपने इंस्टॉलेशन को मैनेज करने के लिए NuGet का इस्तेमाल करें.

NuGet package Manager Console खोलें और यह निर्देश चलाएं:

Install-Package Google.Apis.Dfareporting.v3_4

ज़्यादा जानें

Campaign Manager 360 एपीआई के लिए.NET से जुड़े दस्तावेज़ ब्राउज़ करें.
.NET डेवलपर की गाइड के लिए Google API क्लाइंट लाइब्रेरी पढ़ें.

Java

Java के लिए, Campaign Manager 360 एपीआई क्लाइंट लाइब्रेरी का नया वर्शन इंस्टॉल करें. अपने इंस्टॉलेशन को मैनेज करने के लिए, Maven का इस्तेमाल करने का सुझाव दिया जाता है.

अपनी 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>

ज़्यादा जानें

Campaign Manager 360 एपीआई के लिए JavaDoc रेफ़रंस ब्राउज़ करें.
Java डेवलपर के लिए Google API क्लाइंट लाइब्रेरी की गाइड पढ़ें.

129

PHP के लिए Campaign Manager 360 API क्लाइंट लाइब्रेरी का नया वर्शन इंस्टॉल करें. इंस्टॉल करने की प्रोसेस को मैनेज करने के लिए, कंपोज़र का इस्तेमाल करने का सुझाव दिया जाता है.

टर्मिनल खोलें और यह निर्देश दें:

composer require google/apiclient

अगर आपने पहले ही लाइब्रेरी इंस्टॉल कर ली है और आपको नए वर्शन में अपडेट करना है, तो:

composer update google/apiclient

आपके सिस्टम के हिसाब से, आपको इन कमांड को sudo के साथ जोड़ना होगा.

ज़्यादा जानें

PHP के लिए Google API क्लाइंट लाइब्रेरी की गाइड पढ़ें.

Python

Python के लिए, Campaign Manager 360 API क्लाइंट लाइब्रेरी का नया वर्शन इंस्टॉल करें. अपने इंस्टॉल को मैनेज करने के लिए, पीआईपी का इस्तेमाल करने का सुझाव दिया जाता है.

टर्मिनल खोलें और यह निर्देश दें:

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

आपके सिस्टम के हिसाब से, आपको इन कमांड को sudo के साथ जोड़ना होगा.

ज़्यादा जानें

Campaign Manager 360 एपीआई के लिए PyDoC रेफ़रंस ब्राउज़ करें.
Python डेवलपर की गाइड के लिए Google API क्लाइंट लाइब्रेरी पढ़ें.

Ruby

Ruby के लिए Campaign Manager 360 एपीआई क्लाइंट लाइब्रेरी का नया वर्शन इंस्टॉल करें. अपने इंस्टॉलेशन को मैनेज करने के लिए, RubyGems का इस्तेमाल करें.

टर्मिनल खोलें और यह निर्देश दें:

gem install google-api-client

gem update -y google-api-client

आपके सिस्टम के हिसाब से, आपको इन कमांड को sudo के साथ जोड़ना होगा.

ज़्यादा जानें

Ruby डेवलपर की गाइड के लिए Google API क्लाइंट लाइब्रेरी पढ़ें.

क्लाइंट लाइब्रेरी पेज पर, इन भाषाओं में काम किया जा सकता है.

अनुरोध करें

OAuth 2.0 क्रेडेंशियल बनाने और क्लाइंट लाइब्रेरी इंस्टॉल करने के बाद, Campaign Manager 360 एपीआई का इस्तेमाल किया जा सकता है. नीचे दिए गए क्विकस्टार्ट को फ़ॉलो करके, अपने क्लाइंट को अनुमति देने, कॉन्फ़िगर करने, और पहला अनुरोध करने का तरीका जानें.

C#

क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति देने वाले क्रेडेंशियल जनरेट करें.

पहली बार इस चरण को पूरा करते समय, आपसे ब्राउज़र में अनुमति देने के अनुरोध को स्वीकार करने के लिए कहा जाएगा. स्वीकार करने से पहले, पक्का करें कि आपने ऐसे 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;

एक आधिकारिक Dfa रिपोर्टिंग क्लाइंट बनाएं.

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

कोई कार्रवाई करें.

// 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

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

एक आधिकारिक Dfa रिपोर्टिंग क्लाइंट बनाएं.

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

कोई कार्रवाई करें.

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

129

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

एक आधिकारिक Dfa रिपोर्टिंग क्लाइंट बनाएं.
```
// Create a Dfareporting service object.
$service = new Google_Service_Dfareporting($client);
```

कोई कार्रवाई करें.

// 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

क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति देने वाले क्रेडेंशियल जनरेट करें.

पहली बार इस चरण को पूरा करते समय, आपसे ब्राउज़र में अनुमति देने के अनुरोध को स्वीकार करने के लिए कहा जाएगा. स्वीकार करने से पहले, पक्का करें कि आपने ऐसे 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())
```

एक आधिकारिक Dfa रिपोर्टिंग क्लाइंट बनाएं.

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

कोई कार्रवाई करें.

# 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

# 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

एक आधिकारिक Dfa रिपोर्टिंग क्लाइंट बनाएं.

# 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'

कोई कार्रवाई करें.

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

ज़्यादा जानें

एपीआई की सभी सेवाओं के बारे में जानने के लिए, एपीआई के रेफ़रंस पर जाएं. हर तरीके की जानकारी वाले पेज में एम्बेड किया गया एपीआई एक्सप्लोरर होता है. आप इसका इस्तेमाल करके सीधे अपने ब्राउज़र से टेस्ट के अनुरोध कर सकते हैं.

हमारी अन्य गाइड देखें, जिनमें ऐडवांस विषयों के बारे में बताया गया है. साथ ही, सामान्य कामों के लिए एंड-टू-एंड उदाहरण दिए गए हैं.

जब आप कोड लिखने के लिए तैयार हों, तो बेझिझक हमारे कोड सैंपल का कलेक्शन देखें. इसमें ज़रूरत के मुताबिक बदलाव किए जा सकते हैं.