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

क्लाइंट लाइब्रेरी या REST को इंस्टॉल और कॉन्फ़िगर करने का तरीका यहां बताया गया है.

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

क्लाइंट लाइब्रेरी इंस्टॉल करने से पहले, एपीआई का ऐक्सेस सेट अप करें में दिए गए चरणों को पूरा करें. इसमें ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) कॉन्फ़िगर करना भी शामिल है.

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

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

REST

सेटअप करने के लिए, आपको जिस तरह की प्रोसेस का इस्तेमाल करना है उसे चुनें:

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

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

    #!/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"
      },
      "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

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

अपने प्रोजेक्ट में क्लाइंट लाइब्रेरी के लिए डिपेंडेंसी जोड़ने के लिए, .NET क्लाइंट लाइब्रेरी को इंस्टॉल करने से जुड़ी गाइड में दिए गए निर्देशों का पालन करें.

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी और कोड सैंपल ऐक्सेस करें.

  1. GitHub रिपॉज़िटरी का क्लोन बनाएं.

    git clone https://github.com/googleads/data-manager-dotnet.git

  2. अपने .NET प्रोजेक्ट में, यूटिलिटी लाइब्रेरी पर ProjectReference डिपेंडेंसी का एलान करें. PATH_TO_UTILITY_LIBRARY को उस जगह से बदलें जहां आपने data-manager-dotnet रिपॉज़िटरी को क्लोन किया था.

    <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />

  3. डेटा को फ़ॉर्मैट करने के लिए, अपने .NET प्रोजेक्ट में Formatter यूटिलिटी का इस्तेमाल करें.

  4. samples सबडायरेक्ट्री में या GitHub पर कोड सैंपल ब्राउज़ करें.

    samples डायरेक्ट्री पर जाएं और उपलब्ध सैंपल की सूची पाने के लिए dotnet run का इस्तेमाल करें.

    dotnet run

    अनुमानित पैरामीटर के साथ इस्तेमाल करने के बारे में जानकारी प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें.

    dotnet run -- ingest-audience-members --help

    कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Java

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

अपने प्रोजेक्ट में क्लाइंट लाइब्रेरी की डिपेंडेंसी जोड़ने के लिए, Java क्लाइंट लाइब्रेरी इंस्टॉल करने से जुड़ी गाइड में दिए गए निर्देशों का पालन करें.

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी और कोड सैंपल ऐक्सेस करें.

  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.2.0'

    Maven:

    <dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.2.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 पर मौजूद फ़ाइल का इस्तेमाल करें.

Node.js

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

अपने प्रोजेक्ट में @google-ads/datamanager क्लाइंट लाइब्रेरी की डिपेंडेंसी जोड़ने के लिए, Node.js क्लाइंट लाइब्रेरी इंस्टॉलेशन गाइड में दिए गए निर्देशों का पालन करें.

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी और कोड सैंपल ऐक्सेस करें.

  1. GitHub रिपॉज़िटरी का क्लोन बनाएं.

    git clone https://github.com/googleads/data-manager-node.git

  2. data-manager-node डायरेक्ट्री पर जाएं.

  3. ज़रूरी सॉफ़्टवेयर इंस्टॉल करने के लिए, यह कमांड चलाएं.

    npm install

  4. util डायरेक्ट्री पर जाएं.

    cd util

  5. यूटिलिटी लाइब्रेरी को कंपाइल और पैक करके, .tgz फ़ाइल में बदलने के लिए, यह कमांड चलाएं. इससे npm के साथ इसका इस्तेमाल किया जा सकेगा.

    npm pack

    इस कमांड से, google-ads-datamanager-util-0.2.0.tgz नाम का एक संग्रह जनरेट होता है. फ़ाइल की जगह नोट करें, ताकि अगले चरणों में इसका इस्तेमाल किया जा सके.

  6. अपने Node.js प्रोजेक्ट में, Data Manager API की यूटिलिटी लाइब्रेरी के लिए डिपेंडेंसी का एलान करें. इसके लिए, google-ads-datamanager-util-0.2.0.tgz फ़ाइल के पूरे पाथ और फ़ाइल नाम के लिए dependencies एंट्री जोड़ें.

    {
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}

    डेटा को फ़ॉर्मैट करने के लिए, अपने Node.js प्रोजेक्ट में UserDataFormatter यूटिलिटी का इस्तेमाल करें.

  7. samples सबडायरेक्ट्री में या GitHub पर कोड सैंपल ब्राउज़ करें. नीचे दिया गया तरीका अपनाकर, सैंपल चलाएं:

    1. data-manager-node डायरेक्ट्री पर जाएं.

    2. ज़रूरी आर्ग्युमेंट पास करके, सैंपल चलाएं. इस्तेमाल से जुड़ी जानकारी को प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें. इसमें अनुमानित पैरामीटर शामिल होते हैं.

      उदाहरण के लिए, यहां दी गई कमांड, ingest_audience_members सैंपल को चलाती है और इस्तेमाल करने से जुड़ा स्टेटमेंट प्रिंट करती है:

      npm run ingest-audience-members -w samples -- --help

    कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

PHP

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

अपने प्रोजेक्ट में googleads/data-manager क्लाइंट लाइब्रेरी के लिए डिपेंडेंसी जोड़ने के लिए, PHP क्लाइंट लाइब्रेरी को इंस्टॉल करने से जुड़ी गाइड में दिए गए निर्देशों का पालन करें.

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी और कोड सैंपल ऐक्सेस करें.

  1. GitHub रिपॉज़िटरी का क्लोन बनाएं.

    git clone https://github.com/googleads/data-manager-php.git

  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 सबडायरेक्ट्री में या GitHub पर कोड सैंपल ब्राउज़ करें. नीचे दिया गया तरीका अपनाकर, सैंपल चलाएं:

    1. samples डायरेक्ट्री पर जाएं.

    2. लाइब्रेरी के लिए ज़रूरी सॉफ़्टवेयर से जुड़ी समस्याओं को ठीक करने के लिए, यह कमांड चलाएं:

      composer update --prefer-dist

    3. ज़रूरी आर्ग्युमेंट पास करके, सैंपल चलाएं. इस्तेमाल से जुड़ी जानकारी को प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें. इसमें अनुमानित पैरामीटर शामिल होते हैं.

    कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Python

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

अपने प्रोजेक्ट में google-ads-datamanager क्लाइंट लाइब्रेरी की डिपेंडेंसी जोड़ने के लिए, Python क्लाइंट लाइब्रेरी इंस्टॉल करने से जुड़ी गाइड में दिए गए निर्देशों का पालन करें.

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी और कोड सैंपल ऐक्सेस करें.

  1. GitHub रिपॉज़िटरी का क्लोन बनाएं.

    git clone https://github.com/googleads/data-manager-python.git

  2. data-manager-python डायरेक्ट्री पर जाएं.

  3. Python एनवायरमेंट में यूटिलिटी लाइब्रेरी इंस्टॉल करने के लिए, यह कमांड चलाएं:

    pip install .

  4. अपने Python प्रोजेक्ट में, यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें. उदाहरण के लिए, अगर आपको अपने प्रोजेक्ट में requirements.txt फ़ाइल का इस्तेमाल करना है, तो फ़ाइल में यह लाइन जोड़ें:

    google-ads-data-manager-util=0.2.0

  5. डेटा को फ़ॉर्मैट और एन्क्रिप्ट (सुरक्षित) करने के लिए, अपने Python प्रोजेक्ट में Formatter और Encrypter यूटिलिटी का इस्तेमाल करें.

  6. samples सबडायरेक्ट्री में या GitHub पर कोड सैंपल ब्राउज़ करें. नमूने चलाने के लिए, ज़रूरी डिपेंडेंसी इंस्टॉल करें:

    pip install .[samples]

    अनुमानित पैरामीटर के साथ इस्तेमाल करने के बारे में जानकारी प्रिंट करने के लिए, सैंपल चलाते समय --help आर्ग्युमेंट पास करें.

    कुछ सैंपल डेटा के साथ शुरुआत करने के लिए, samples/sampledata/audience_members_1.csv पर मौजूद फ़ाइल का इस्तेमाल करें.

Ruby

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

अपने प्रोजेक्ट में क्लाइंट लाइब्रेरी की डिपेंडेंसी जोड़ने के लिए, Ruby क्लाइंट लाइब्रेरी इंस्टॉल करने से जुड़े दिशा-निर्देश में दिए गए निर्देशों का पालन करें.

अगले चरण

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