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

यहां क्लाइंट लाइब्रेरी या 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 then the command that
# specifies --scopes fails, so 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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

    डेटा पार्टनर

    #!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

.NET

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

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

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी के अलावा, यूटिलिटी लाइब्रेरी भी इंस्टॉल की जा सकती है. इससे डेटा को इंजेस्ट करने के लिए फ़ॉर्मैट करने जैसे सामान्य कामों में मदद मिलती है.

  1. अपने .NET प्रोजेक्ट में, Google.Ads.DataManager.Util यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें.

    dotnet add package Google.Ads.DataManager.Util --version 0.4.0

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

कोड सैंपल ब्राउज़ करें

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

सैंपल चलाने के लिए:

  1. v0.4.0 टैग पर, GitHub रिपॉज़िटरी को क्लोन करें:

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

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

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

    dotnet run

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

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

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

ऐप पर जाएं

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

go get cloud.google.com/go/datamanager/apiv1@latest

ज़्यादा जानकारी के लिए, Go क्लाइंट लाइब्रेरी गाइड में दिए गए निर्देशों का पालन करें.

Java

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

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

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी के अलावा, यूटिलिटी लाइब्रेरी भी इंस्टॉल की जा सकती है. इससे डेटा को डालने के लिए, उसे फ़ॉर्मैट और एन्क्रिप्ट (सुरक्षित) करने जैसे सामान्य कामों में मदद मिलती है.

  1. अपने Java प्रोजेक्ट में, data-manager-util यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें.

    Gradle:

    implementation 'com.google.api-ads:data-manager-util:0.4.0'

    Maven:

    <dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.4.0</version>
</dependency>

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

कोड सैंपल ब्राउज़ करें

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

सैंपल चलाने के लिए:

  1. v0.4.0 टैग पर, GitHub रिपॉज़िटरी को क्लोन करें:

    git clone --branch v0.4.0 https://github.com/googleads/data-manager-java.git

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

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

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

    ./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'

सैंपल डेटा के साथ शुरुआत करने के लिए, data-manager-samples/src/main/resources/sampledata पर मौजूद फ़ाइलों का इस्तेमाल करें.

Node.js

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

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

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी के अलावा, यूटिलिटी लाइब्रेरी भी इंस्टॉल की जा सकती है. इससे डेटा को इंजेस्ट करने के लिए फ़ॉर्मैट करने जैसे सामान्य कामों में मदद मिलती है.

  1. अपने Node.js प्रोजेक्ट में, @google-ads/datamanager-util यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें:

    npm install @google-ads/datamanager-util

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

कोड सैंपल ब्राउज़ करें

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

सैंपल चलाने के लिए:

  1. v0.4.1 टैग पर, GitHub रिपॉज़िटरी को क्लोन करें:

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

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

  3. सैंपल चलाने के लिए डिपेंडेंसी इंस्टॉल करें:

    npm install

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

    उदाहरण के लिए, यहां दिया गया निर्देश ingest-audience-members सैंपल को चलाता है और इस्तेमाल की जानकारी प्रिंट करता है:

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

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

PHP

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

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

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी के अलावा, यूटिलिटी लाइब्रेरी भी इंस्टॉल की जा सकती है. इससे डेटा को इंजेस्ट करने के लिए फ़ॉर्मैट करने जैसे सामान्य कामों में मदद मिलती है.

  1. उसी होस्ट पर अपने PHP प्रोजेक्ट की composer.json फ़ाइल में, यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें:

    composer require googleads/data-manager-util

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

कोड सैंपल ब्राउज़ करें

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

सैंपल चलाने के लिए:

  1. v0.4.0 टैग पर, GitHub रिपॉज़िटरी को क्लोन करें:

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

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

  3. सैंपल चलाने के लिए डिपेंडेंसी इंस्टॉल करें:

    composer install

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

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

    php audiences/ingest_audience_members.php --help

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

Python

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

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

ज़रूरी नहीं: यूटिलिटी लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी के अलावा, यूटिलिटी लाइब्रेरी भी इंस्टॉल की जा सकती है. इससे डेटा को डालने के लिए, उसे फ़ॉर्मैट और एन्क्रिप्ट (सुरक्षित) करने जैसे सामान्य कामों में मदद मिलती है.

  1. अपने Python प्रोजेक्ट में, google-ads-datamanager-util यूटिलिटी लाइब्रेरी पर डिपेंडेंसी का एलान करें.

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

    google-ads-datamanager-util==0.4.0

    इसके अलावा, यूटिलिटी लाइब्रेरी को सीधे इंस्टॉल करें:

    pip install google-ads-datamanager-util==0.4.0

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

कोड सैंपल ब्राउज़ करें

  1. v0.4.0 टैग पर, GitHub रिपॉज़िटरी को क्लोन करें:

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

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

  3. सैंपल चलाने के लिए डिपेंडेंसी इंस्टॉल करें:

    pip install -r samples/requirements.txt

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

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

    python3 samples/audiences/ingest_audience_members.py --help

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

Ruby

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

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

अगले चरण

पीछे जाएं
एपीआई ऐक्सेस सेट अप करना
आगे बढ़ें
एजेंट की स्किल