ক্লায়েন্ট লাইব্রেরি ইনস্টল করা

ক্লায়েন্ট লাইব্রেরি বা REST কীভাবে ইনস্টল ও কনফিগার করবেন তা এখানে দেওয়া হল।

পূর্বশর্ত

ক্লায়েন্ট লাইব্রেরি ইনস্টল করার আগে, API অ্যাক্সেস সেট-আপ করুন লিঙ্কে দেওয়া ধাপগুলি সম্পূর্ণ করুন, এর মধ্যে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) কনফিগার করা অন্তর্ভুক্ত।

ইনস্টলেশনের ধাপ

আপনার লোকাল মেশিনে, আপনার পছন্দমতো ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন:

REST

  1. আপনার অ্যাকাউন্ট ও গন্তব্যের ভ্যালু দিয়ে নিম্নলিখিত নমুনায় প্লেসহোল্ডার আপডেট করুন, যেমন OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ও AUDIENCE_ID।
  2. আপনার Google Cloud-এর আইডি দিয়ে PROJECT_ID পাল্টে দিন।

  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. GitHub রিপোজিটরি ক্লোন করুন v0.4.0 ট্যাগ থেকে:

    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. GitHub রিপোজিটরি ক্লোন করুন v0.4.0 ট্যাগ থেকে:

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

  2. data-manager-java ডিরেক্টরিতে নেভিগেট করুন।

  3. প্রয়োজনীয় আর্গুমেন্ট পাস করে, Gradle run টাস্ক ব্যবহার করে কমান্ড লাইন থেকে স্যাম্পেল রান করান। প্রত্যাশিত প্যারামিটার সহ ব্যবহারের বিবৃতি প্রিন্ট করার জন্য কোনও নমুনা চালানোর সময় --help আর্গুমেন্ট পাস করুন।

    যেমন, নিম্নলিখিত কমান্ডটি IngestAudienceMembers sample রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

    ./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. GitHub রিপোজিটরি ক্লোন করুন v0.4.1 ট্যাগ থেকে:

    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 sample রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

    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. GitHub রিপোজিটরি ক্লোন করুন v0.4.0 ট্যাগ থেকে:

    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 sample রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

    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. GitHub রিপোজিটরি ক্লোন করুন v0.4.0 ট্যাগ থেকে:

    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 sample রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

    python3 samples/audiences/ingest_audience_members.py --help

কিছু নমুনা ডেটা দিয়ে শুরু করার ব্যাপারে সাহায্য পেতে, samples/sampledata-এ থাকা ফাইল ব্যবহার করুন।

Ruby

ক্লায়েন্ট লাইব্রেরি ইনস্টল করা

আপনার প্রোজেক্টে ক্লায়েন্ট লাইব্রেরিতে কোনও ডিপেন্ডেন্সি যোগ করতে, Ruby ক্লায়েন্ট লাইব্রেরি ইনস্টলেশন গাইড-এ দেওয়া নির্দেশাবলী অনুসরণ করুন।

পরবর্তী ধাপ

পূর্ববর্তী
API অ্যাক্সেস সেট-আপ করা
পরবর্তী
এজেন্টের দক্ষতা