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

एपीआई ऐक्सेस सेट अप करना

एसडीके या REST की मदद से, Data Manager API का ऐक्सेस सेट अप करने का तरीका यहां बताया गया है.

ज़रूरी शर्तें

डेटा एपीआई का इस्तेमाल करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

एक Google Cloud प्रोजेक्ट.
ऐसा Google खाता जिसके पास आपके Google Cloud प्रोजेक्ट पर serviceusage.services.enable की अनुमति हो या जिसके पास ऐसी भूमिका हो जिसमें यह अनुमति शामिल हो. उदाहरण के लिए, roles/owner और roles/serviceusage.serviceUsageAdmin, दोनों में serviceusage.services.enable की अनुमति शामिल है. अनुमतियां देखने के लिए, मौजूदा ऐक्सेस देखें पर जाएं.

एपीआई चालू करना

अगर आपने अब तक ऐसा नहीं किया है, तो Data Manager API चालू करें पर क्लिक करके, Data Manager API चालू करें. इसके अलावा, इस चरण को मैन्युअल तरीके से पूरा करने के लिए, निर्देशों का पालन करें.

अगर आपको Data Manager API नहीं मिल रहा है या Data Manager API चालू करें विकल्प काम नहीं कर रहा है, तो पुष्टि करें कि आपका Google खाता ज़रूरी शर्तों को पूरा करता हो.

पुष्टि करने की सुविधा सेट अप करना

एपीआई कुंजियों के अलावा, Google पर पुष्टि करने के किसी भी तरीके का इस्तेमाल किया जा सकता है. हमारा सुझाव है कि आप अपने इस्तेमाल के उदाहरण के लिए पुष्टि करने का सही तरीका चुनने के बारे में पढ़ें. इससे आपको यह तय करने में मदद मिलेगी कि आपके इस्तेमाल के उदाहरण के लिए कौनसा तरीका सही है.

पुष्टि करने के दो सामान्य तरीके हैं: उपयोगकर्ता खाते और सेवा खाते:

उपयोगकर्ता खाते: ये उन लोगों के खाते होते हैं जो सीधे तौर पर Google API और सेवाओं का इस्तेमाल करते हैं.
सेवा खाते: ये उपयोगकर्ताओं के तौर पर लोगों के बजाय ऐप्लिकेशन को दिखाते हैं. इनकी मदद से, आपके ऐप्लिकेशन पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज कर पाते हैं. उदाहरण के लिए, अगर किसी ऐप्लिकेशन को Google Cloud के संसाधनों को ऐक्सेस करना है.

आपका इंटिग्रेशन, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल करके, एनवायरमेंट से क्रेडेंशियल अपने-आप ढूंढ सकता है. इससे आपको पुष्टि करने के लिए, क्लाइंट कोड में बदलाव नहीं करना पड़ेगा.

एडीसी सेट अप करने के लिए, उपयोगकर्ता खाता या सेवा खाते के तौर पर काम करना चुनें:

उपयोगकर्ता खाते के क्रेडेंशियल की मदद से पुष्टि करने का तरीका यहां दिया गया है:

अपने प्रोजेक्ट के लिए, Google Auth Platform की सेटिंग कॉन्फ़िगर करें.

अहम जानकारी: Data Manager API के स्कोप के लिए, उपयोगकर्ता के क्रेडेंशियल पाने के लिए इस्तेमाल किए जाने वाले किसी भी Google Cloud ऐप्लिकेशन की Google OAuth की पुष्टि होनी चाहिए. इससे उपयोगकर्ताओं को पुष्टि न की गई यूज़र इंटरफ़ेस (यूआई) स्क्रीन नहीं दिखेगी. सेवा खातों के लिए, Google OAuth की पुष्टि करना ज़रूरी नहीं है.
1. Google Cloud Console में, ब्रैंडिंग पेज खोलें.
2. अपना प्रोजेक्ट चुनें.
3. फ़ॉर्म भरें और बनाएं पर क्लिक करें.
डेटा मैनेजर एपीआई का स्कोप संवेदनशील स्कोप होता है. इसलिए, ये चरण पूरे करना ज़रूरी है:
1. अपने प्रोजेक्ट के लिए, डेटा ऐक्सेस सेटिंग पर जाएं.
2. स्कोप जोड़ें या हटाएं पर क्लिक करें.
3. स्कोप की सूची में, Data Manager API के बगल में मौजूद बॉक्स पर सही का निशान लगाएं. इसके बाद, अपडेट करें पर क्लिक करें.
4. सेव करें पर क्लिक करें.
5. Google Cloud Console में Audience पर जाएं. इसके बाद, पब्लिश करने की स्थिति और उपयोगकर्ता का टाइप अपडेट करें. ऐप्लिकेशन ऑडियंस मैनेज करें में इन सेटिंग के बारे में ज़्यादा जानें.
प्रोजेक्ट में OAuth2 क्लाइंट बनाने के लिए, OAuth2 क्लाइंट बनाएं पर क्लिक करें. इसके अलावा, डेस्कटॉप OAuth2 क्लाइंट बनाने के लिए, निर्देशों का पालन करें.

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

PATH_TO_CLIENT_JSON की जगह, डाउनलोड की गई JSON फ़ाइल का नाम डालें.
```
gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"
```
पुष्टि करें कि क्रेडेंशियल को इस कमांड का इस्तेमाल करके सही तरीके से सेट अप किया गया है. अगर यह कमांड काम करती है, तो कंसोल पर ऐक्सेस टोकन प्रिंट हो जाता है.
```
gcloud auth application-default print-access-token
```

अपने ऐप्लिकेशन के लिए पुष्टि करने और क्रेडेंशियल के बारे में ज़्यादा जानने के लिए, Google पर पुष्टि करने के तरीके और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल कैसे काम करते हैं लेख पढ़ें.

ऑपरेटिंग खाते का ऐक्सेस सेट अप करना

अपने उपयोगकर्ता खाते से जुड़े ईमेल पते को Destination का ऐक्सेस दें.

अगर Google Ads या डेटा पार्टनर खाते का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
Display & Video 360 खाते का इस्तेमाल करने पर, खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.

अपनी प्रोग्रामिंग लैंग्वेज के लिए एसडीके सेट अप करना

अपने कंप्यूटर पर, अपनी पसंद का एसडीके इंस्टॉल करें:

REST

यहां दिए गए सैंपल में, प्लेसहोल्डर को अपने खाते और डेस्टिनेशन की वैल्यू से अपडेट करें. जैसे, OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, और AUDIENCE_ID.
PROJECT_ID की जगह अपना Google Cloud आईडी डालें.

अनुरोध भेजने के लिए, सैंपल को कमांड लाइन पर कॉपी करें.

अगर आपको प्रॉडक्ट लिंक का इस्तेमाल करके operatingAccount को ऐक्सेस नहीं करना है, तो destinations में मौजूद एंट्री का linkedAccount एट्रिब्यूट हटाएं.

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account, the command that specifies
# --scopes fails. This sample falls back to the command without the
# --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
  gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If you
# get scope-related errors when you send the request in the next step,
# verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

.NET

google-cloud-ads-datamanager-v1-csharp.tar.gz को डाउनलोड करें और निकालें.
अपने .NET प्रोजेक्ट में, Data Manager API लाइब्रेरी पर ProjectReference डिपेंडेंसी का एलान करें. PATH_TO_CLIENT_LIBRARY को उस जगह से बदलें जहाँ आपने google-cloud-ads-datamanager-v1-csharp.tar.gz से google-cloud-ads-datamanager-v1-csharp डायरेक्ट्री को एक्सट्रैक्ट किया था.
```
<ProjectReference Include="PATH_TO_CLIENT_LIBRARY\Google.Ads.DataManager.V1\Google.Ads.DataManager.V1.csproj" />
```
Optional. यूटिलिटी लाइब्रेरी और कोड सैंपल पाएं.
1. data-manager-dotnet.tar.gz को डाउनलोड और एक्सट्रैक्ट करें.
2. अपने .NET प्रोजेक्ट में, यूटिलिटी लाइब्रेरी पर ProjectReference डिपेंडेंसी का एलान करें. PATH_TO_UTILITY_LIBRARY को उस जगह से बदलें जहाँ आपने data-manager-dotnet.tar.gz से data-manager-dotnet डायरेक्ट्री को एक्सट्रैक्ट किया था.
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
3. डेटा को फ़ॉर्मैट करने के लिए, अपने .NET प्रोजेक्ट में Formatter यूटिलिटी का इस्तेमाल करें.
4. samples सबडायरेक्ट्री में कोड के सैंपल ब्राउज़ करें.
  
  कोड सैंपल चलाने के लिए, DATA_MANAGER_DOTNET_LIB एनवायरमेंट वैरिएबल को उस जगह पर सेट करें जहां आपने google-cloud-ads-datamanager-v1-csharp.tar.gz से google-cloud-ads-datamanager-v1-csharp डायरेक्ट्री को एक्सट्रैक्ट किया था.
```
export DATA_MANAGER_DOTNET_LIB="PATH_TO_CLIENT_LIBRARY"
```
  samples डायरेक्ट्री पर जाएं और उपलब्ध सैंपल की सूची पाने के लिए, dotnet run का इस्तेमाल करें.
```
dotnet run --framework net8.0
```
  अनुमानित पैरामीटर के साथ इस्तेमाल करने के बारे में जानकारी प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें.
```
dotnet run --framework net8.0 -- ingest-audience-members --help
```
  कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Java

google-cloud-ads-datamanager-v1-java.tar.gz को डाउनलोड और एक्सट्रैक्ट करें.
google-cloud-ads-datamanager-v1-java डायरेक्ट्री पर जाएं.
Maven या Gradle के साथ इस्तेमाल करने के लिए, लाइब्रेरी को अपनी लोकल Maven रिपॉज़िटरी में बनाने और पब्लिश करने के लिए, यह कमांड चलाएं.
```
./gradlew install
```

अपने Java प्रोजेक्ट में, Data Manager API लाइब्रेरी के लिए डिपेंडेंसी का एलान करें.

Gradle:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.3'

Maven:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.3</version>
</dependency>

Optional. यूटिलिटी लाइब्रेरी और कोड सैंपल पाएं.
1. GitHub रिपॉज़िटरी का क्लोन बनाएं.
```
git clone https://github.com/googleads/data-manager-java.git
```
2. data-manager-java डायरेक्ट्री पर जाएं.
3. यूटिलिटी लाइब्रेरी बनाएं और उसे अपने लोकल मेवन रिपॉज़िटरी में पब्लिश करें.
```
./gradlew data-manager-util:install
```
4. अपने Java प्रोजेक्ट में, यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें.
  
  Gradle:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  Maven:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. डेटा को फ़ॉर्मैट और एन्क्रिप्ट (सुरक्षित) करने के लिए, अपने Java प्रोजेक्ट में UserDataFormatter और Encrypter यूटिलिटी का इस्तेमाल करें.
6. data-manager-samples सबडायरेक्ट्री में या GitHub पर कोड के सैंपल ब्राउज़ करें. कमांड लाइन से किसी सैंपल को चलाने के लिए, Gradle run टास्क का इस्तेमाल करें.
  
  उदाहरण के लिए, यहां दिया गया निर्देश IngestAudienceMembers सैंपल को चलाता है और इस्तेमाल से जुड़ा स्टेटमेंट प्रिंट करता है:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, data-manager-samples/src/main/resources/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Python

ads-datamanager-v1-py.tar.gz डाउनलोड करें.
डाउनलोड की गई फ़ाइल की डायरेक्ट्री पर जाएं.
लाइब्रेरी बनाने और उसे एक ही Python एनवायरमेंट में मौजूद अन्य प्रोजेक्ट के लिए उपलब्ध कराने के लिए, यह कमांड चलाएं:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
अपने Python प्रोजेक्ट में, Data Manager API लाइब्रेरी पर निर्भरता का एलान करें. उदाहरण के लिए, अगर आपको अपने प्रोजेक्ट में requirements.txt फ़ाइल का इस्तेमाल करना है, तो फ़ाइल में यह लाइन जोड़ें:
```
google-ads-data-manager=0.1.3
```
Optional. यूटिलिटी लाइब्रेरी और कोड सैंपल पाएं.
1. data-manager-python.tar.gz को डाउनलोड और एक्सट्रैक्ट करें.
2. data-manager-python डायरेक्ट्री पर जाएं.
3. अपने Python एनवायरमेंट में यूटिलिटी लाइब्रेरी इंस्टॉल करने के लिए, यह कमांड चलाएं:
```
pip install .
```
4. अपने Python प्रोजेक्ट में, यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें. उदाहरण के लिए, अगर आपको अपने प्रोजेक्ट में requirements.txt फ़ाइल का इस्तेमाल करना है, तो फ़ाइल में यह लाइन जोड़ें:
```
google-ads-data-manager-util=0.1.0
```
5. डेटा को फ़ॉर्मैट और एन्क्रिप्ट (सुरक्षित) करने के लिए, अपने Python प्रोजेक्ट में Formatter और Encrypter यूटिलिटी का इस्तेमाल करें.
6. samples सबडायरेक्ट्री में कोड के सैंपल ब्राउज़ करें. सैंपल को चलाने के दौरान, --help आर्ग्युमेंट पास करें, ताकि अनुमानित पैरामीटर के साथ इस्तेमाल से जुड़ा स्टेटमेंट प्रिंट किया जा सके.
  
  कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Node.js

ads-datamanager-v1-nodejs.tar.gz को डाउनलोड करें और अनज़िप करें.
ads-datamanager-v1-nodejs डायरेक्ट्री पर जाएं.
लाइब्रेरी को कंपाइल और पैक करके .tgz फ़ाइल में बदलने के लिए, ये कमांड चलाएं. इससे npm के साथ लाइब्रेरी का इस्तेमाल किया जा सकेगा.
```
npm install
npm pack
```
इन कमांड से, google-cloud-datamanager-0.1.3.tgz नाम का एक संग्रह जनरेट होता है.
अपने Node.js प्रोजेक्ट में, Data Manager API लाइब्रेरी पर निर्भरता का एलान करें. इसके लिए, google-cloud-datamanager-0.1.3.tgz फ़ाइल के पूरे पाथ और फ़ाइल नाम के लिए dependencies एंट्री जोड़ें.

PHP

google-cloud-ads-datamanager-v1-php.tar.gz को डाउनलोड और एक्सट्रैक्ट करें.
google-cloud-ads-datamanager-v1-php डायरेक्ट्री पर जाएं.
लाइब्रेरी के लिए ज़रूरी सॉफ़्टवेयर से जुड़ी समस्याओं को ठीक करने के लिए, यह कमांड चलाएं:
```
composer update --prefer-dist
```
उसी होस्ट पर मौजूद अपने PHP प्रोजेक्ट की composer.json फ़ाइल में, यहां दिया गया तरीका अपनाकर Data Manager API लाइब्रेरी पर डिपेंडेंसी का एलान करें:
1. एक repositories सेक्शन जोड़ें, जो google-cloud-ads-datamanager-v1-php डायरेक्ट्री की जगह की ओर इशारा करता हो.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_CLIENT_LIBRARY"
   }
]
```
2. Data Manager API लाइब्रेरी पर डिपेंडेंसी का एलान करें.
```
"require": {
   "googleads/data-manager": "0.1.3"
}
```
(ज़रूरी नहीं) यूटिलिटी लाइब्रेरी और कोड के सैंपल पाएं.
1. data-manager-php.tar.gz को डाउनलोड और एक्सट्रैक्ट करें.
2. data-manager-php डायरेक्ट्री पर जाएं.
3. लाइब्रेरी के लिए ज़रूरी सॉफ़्टवेयर से जुड़ी समस्याओं को ठीक करने के लिए, यह कमांड चलाएं:
```
composer update --prefer-dist
```
4. उसी होस्ट पर मौजूद अपने PHP प्रोजेक्ट की composer.json फ़ाइल में, यहां दिया गया तरीका अपनाकर यूटिलिटी लाइब्रेरी के लिए डिपेंडेंसी का एलान करें:
  1. repositories सेक्शन में एक एंट्री जोड़ें, जो data-manager-php डायरेक्ट्री की जगह की ओर ले जाती हो.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
  2. यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें.
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
  डेटा को फ़ॉर्मैट करने के लिए, अपने PHP प्रोजेक्ट में Formatter यूटिलिटी का इस्तेमाल करें.
5. samples सबडायरेक्ट्री में कोड के सैंपल ब्राउज़ करें. यहां दिए गए तरीके का इस्तेमाल करके, सैंपल चलाएं:
  1. samples डायरेक्ट्री पर जाएं.
  2. DATA_MANAGER_PHP_LIB एनवायरमेंट वैरिएबल को उस पाथ पर सेट करें जहां आपने क्लाइंट लाइब्रेरी को एक्सट्रैक्ट किया है.
```
export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"
```
  3. लाइब्रेरी के लिए ज़रूरी सॉफ़्टवेयर से जुड़ी समस्याओं को ठीक करने के लिए, यह कमांड चलाएं:
```
composer update --prefer-dist
```
  4. ज़रूरी आर्ग्युमेंट पास करके, सैंपल चलाएं. इस्तेमाल से जुड़ी जानकारी को प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें. इसमें अनुमानित पैरामीटर शामिल होते हैं.
  कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

अगले चरण

ऑडियंस का डेटा भेजने के बारे में ज़्यादा जानें.
इवेंट भेजने के बारे में ज़्यादा जानें.
REST या RPC के रेफ़रंस दस्तावेज़ ब्राउज़ करें.