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

क्लाइंट लाइब्रेरी या 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 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. 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 पर मौजूद फ़ाइलों का इस्तेमाल करें.

ऐप पर जाएं

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

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 क्लाइंट लाइब्रेरी इंस्टॉल करने से जुड़े दिशा-निर्देश में दिए गए निर्देशों का पालन करें.

अगले चरण

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