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

यहां क्लाइंट लाइब्रेरी या 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 सबडायरेक्ट्री या on GitHub पर, कोड सैंपल ब्राउज़ करें.

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

    dotnet run

    किसी सैंपल को चलाते समय, --help आर्ग्युमेंट पास करें, ताकि इस्तेमाल करने के निर्देश के साथ-साथ, ज़रूरी पैरामीटर भी दिखें.

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

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

Go

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

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

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

Java

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

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

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

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

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

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

  3. यूटिलिटी लाइब्रेरी बनाएं और उसे अपने लोकल Maven रिपॉज़िटरी पर पब्लिश करें.

    ./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 सबडायरेक्ट्री या on 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. npm के साथ इस्तेमाल करने के लिए, यूटिलिटी लाइब्रेरी को कंपाइल और पैक करके .tgz फ़ाइल में बदलने के लिए, यह निर्देश चलाएं.

    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 सबडायरेक्ट्री या on 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 सबडायरेक्ट्री या on 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-datamanager-util=0.2.0

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

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

    pip install .[samples]

    किसी सैंपल को चलाते समय, --help आर्ग्युमेंट पास करें, ताकि इस्तेमाल करने के निर्देश के साथ-साथ, ज़रूरी पैरामीटर भी दिखें.

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

Ruby

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

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

अगले चरण

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