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

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

Google Cloud का कमांड-लाइन इंटरफ़ेस सेट अप करना

  1. Google Cloud के कमांड-लाइन इंटरफ़ेस को इंस्टॉल और शुरू करें.

  2. यह पक्का करने के लिए कि आपके gcloud कॉम्पोनेंट अप-टू-डेट हैं, यह कमांड चलाएं.

    gcloud components update

  3. (ज़रूरी नहीं) डिफ़ॉल्ट प्रोजेक्ट और क्षेत्र सेट करने के लिए, gcloud config set कमांड का इस्तेमाल करें.

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

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

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

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

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

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

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

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

अपनी प्रोग्रामिंग भाषा के लिए SDK सेट अप करना

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

REST

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

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

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

    #!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "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

Java

  1. google-cloud-ads-datamanager-v1-java.tar.gz डाउनलोड करें और उसे अनपैक करें.
  2. google-cloud-ads-datamanager-v1-java डायरेक्ट्री पर जाएं.

  3. Maven या Gradle के साथ इस्तेमाल करने के लिए, लाइब्रेरी को अपने स्थानीय Maven डेटा स्टोर में बनाने और पब्लिश करने के लिए, यह कमांड चलाएं.

    ./gradlew -Pversion=0.1.0 install

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

    Gradle:

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

    Maven:

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

  5. Optional. यूटिलिटी लाइब्रेरी और कोड सैंपल पाएं.

    1. data-manager-java.tar.gz डाउनलोड करके, उसे अनपैक करें.
    2. data-manager-java डायरेक्ट्री पर जाएं.

    3. Maven या Gradle के लिए, यह कमांड चलाएं. यह कमांड, आपकी लोकल मेवन रिपॉज़िटरी में यूटिलिटी लाइब्रेरी को बनाता और पब्लिश करता है.

      ./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 डायरेक्ट्री में कोड के सैंपल ब्राउज़ करें. कमांड लाइन से कोई सैंपल चलाने के लिए, Gradle run टास्क का इस्तेमाल करें.

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

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

      सैंपल डेटा का इस्तेमाल शुरू करने के लिए, data-manager-samples/src/main/resources/sampledata/audience_members_1.csv पर दी गई फ़ाइल का इस्तेमाल करें.

Python

  1. ads-datamanager-v1-py.tar.gz डाउनलोड करें.
  2. डाउनलोड की डायरेक्ट्री पर जाएं.

  3. लाइब्रेरी बनाने और उसे उसी Python एनवायरमेंट में मौजूद अन्य प्रोजेक्ट के लिए उपलब्ध कराने के लिए, यह कमांड चलाएं:

    pip install ./ads-datamanager-v1-py.tar.gz

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

    google-ads-data-manager=0.1.0

  5. 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

  1. ads-datamanager-v1-nodejs.tar.gz डाउनलोड करें और उसे अनपैक करें.
  2. ads-datamanager-v1-nodejs डायरेक्ट्री पर जाएं.

  3. npm के साथ इस्तेमाल करने के लिए, लाइब्रेरी को .tgz फ़ाइल में कंपाइल और पैक करने के लिए, ये कमांड चलाएं.

    npm install
npm pack

    ये निर्देश, google-cloud-datamanager-0.1.0.tgz नाम का एक संग्रह जनरेट करते हैं.

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

PHP

  1. google-cloud-ads-datamanager-v1-php.tar.gz डाउनलोड करें और उसे अनपैक करें.
  2. google-cloud-ads-datamanager-v1-php डायरेक्ट्री पर जाएं.

  3. लाइब्रेरी के लिए डिपेंडेंसी हल करने के लिए, यह कमांड चलाएं:

    composer update --prefer-dist

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

    a. repositories सेक्शन जोड़ें, जो google-cloud-ads-datamanager-v1-php डायरेक्ट्री की जगह की जानकारी देता हो.

     "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]

    b. Data Manager API लाइब्रेरी पर डिपेंडेंसी का एलान करें.

     "require": {
    "googleads/data-manager": "^0.1.0"
 }