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

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

পূর্বশর্ত

ক্লায়েন্ট লাইব্রেরি ইনস্টল করার আগে, অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) কনফিগার করা সহ ‘এপিআই অ্যাক্সেস সেট আপ করুন’ -এর ধাপগুলো সম্পূর্ণ করুন।

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

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

বিশ্রাম

  1. নিম্নলিখিত নমুনায় থাকা OPERATING_ACCOUNT_PRODUCT , OPERATING_ACCOUNT_ID , এবং AUDIENCE_ID মতো প্লেসহোল্ডারগুলিকে আপনার অ্যাকাউন্ট এবং গন্তব্যের মান দিয়ে আপডেট করুন।
  2. 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 সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন।

নমুনা চালানোর জন্য:

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

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

জাভা

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

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

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন।

ক্লায়েন্ট লাইব্রেরির পাশাপাশি, ডেটা ইনজেশনের জন্য ফরম্যাটিং ও এনক্রিপ্ট করার মতো সাধারণ কাজগুলোতে সাহায্য করার জন্য আপনি ইউটিলিটি লাইব্রেরিটি ইনস্টল করতে পারেন।

  1. আপনার জাভা প্রজেক্টে data-manager-util ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন।

    গ্রেডল:

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

    ম্যাভেন:

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

  2. ডেটা ফরম্যাট ও এনক্রিপ্ট করতে আপনার জাভা প্রজেক্টে UserDataFormatter এবং Encrypter ইউটিলিটিগুলো ব্যবহার করুন।

কোডের নমুনা ব্রাউজ করুন

data-manager-samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন।

নমুনা চালানোর জন্য:

  1. 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 স্যাম্পলটি চালায় এবং ব্যবহারের নির্দেশাবলী প্রিন্ট করে: 

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

কিছু নমুনা ডেটা দিয়ে কাজ শুরু করার জন্য, data-manager-samples/src/main/resources/sampledata -এ থাকা ফাইলগুলো ব্যবহার করুন।

নোড.জেএস

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

আপনার প্রজেক্টে @google-ads/datamanager ক্লায়েন্ট লাইব্রেরির ডিপেন্ডেন্সি যোগ করতে Node.js ক্লায়েন্ট লাইব্রেরি ইনস্টলেশন গাইডের নির্দেশাবলী অনুসরণ করুন।

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন।

ক্লায়েন্ট লাইব্রেরির পাশাপাশি, ডেটা ইনজেশনের জন্য ফরম্যাট করার মতো সাধারণ কাজগুলোতে সাহায্য করার জন্য আপনি ইউটিলিটি লাইব্রেরিটি ইনস্টল করতে পারেন।

  1. আপনার Node.js প্রজেক্টে, @google-ads/datamanager-util ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন: 

    npm install @google-ads/datamanager-util

  2. ডেটা ফরম্যাট করার জন্য আপনার Node.js প্রজেক্টে UserDataFormatter ইউটিলিটিটি ব্যবহার করুন।

কোডের নমুনা ব্রাউজ করুন

samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন।

নমুনা চালানোর জন্য:

  1. 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 স্যাম্পলটি চালায় এবং ব্যবহারের নির্দেশাবলী প্রিন্ট করে: 

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

কিছু নমুনা ডেটা দিয়ে কাজ শুরু করার জন্য, samples/sampledata ফোল্ডারের ফাইলগুলো ব্যবহার করুন।

পিএইচপি

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

আপনার প্রজেক্টে googleads/data-manager ক্লায়েন্ট লাইব্রেরির ডিপেন্ডেন্সি যোগ করতে PHP ক্লায়েন্ট লাইব্রেরি ইনস্টলেশন গাইডের নির্দেশাবলী অনুসরণ করুন।

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন।

ক্লায়েন্ট লাইব্রেরির পাশাপাশি, ডেটা ইনজেশনের জন্য ফরম্যাট করার মতো সাধারণ কাজগুলোতে সাহায্য করার জন্য আপনি ইউটিলিটি লাইব্রেরিটি ইনস্টল করতে পারেন।

  1. একই হোস্টে থাকা আপনার PHP প্রজেক্টের composer.json ফাইলে, ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন: 

    composer require googleads/data-manager-util

  2. ডেটা ফরম্যাট করার জন্য আপনার PHP প্রজেক্টে Formatter ইউটিলিটি ব্যবহার করুন।

কোডের নমুনা ব্রাউজ করুন

samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন।

নমুনা চালানোর জন্য:

  1. 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 স্যাম্পলটি চালায় এবং ব্যবহারের নির্দেশাবলী প্রিন্ট করে: 

    php audiences/ingest_audience_members.php --help

কিছু নমুনা ডেটা দিয়ে কাজ শুরু করার জন্য, samples/sampledata ফোল্ডারের ফাইলগুলো ব্যবহার করুন।

পাইথন

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

আপনার প্রজেক্টে google-ads-datamanager ক্লায়েন্ট লাইব্রেরির ডিপেন্ডেন্সি যোগ করতে পাইথন ক্লায়েন্ট লাইব্রেরি ইনস্টলেশন গাইডের নির্দেশাবলী অনুসরণ করুন।

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন।

ক্লায়েন্ট লাইব্রেরির পাশাপাশি, ডেটা ইনজেশনের জন্য ফরম্যাটিং ও এনক্রিপ্ট করার মতো সাধারণ কাজগুলোতে সাহায্য করার জন্য আপনি ইউটিলিটি লাইব্রেরিটি ইনস্টল করতে পারেন।

  1. আপনার পাইথন প্রজেক্টে google-ads-datamanager-util ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন।

    উদাহরণস্বরূপ, আপনার প্রজেক্টে requirements.txt ফাইল ব্যবহার করলে, ফাইলটিতে নিম্নলিখিত লাইনটি যোগ করুন: 

    google-ads-datamanager-util==0.4.0

    অথবা সরাসরি ইউটিলিটি লাইব্রেরিটি ইনস্টল করুন: 

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

  2. ডেটা ফরম্যাট ও এনক্রিপ্ট করতে আপনার পাইথন প্রজেক্টে Formatter এবং Encrypter ইউটিলিটিগুলো ব্যবহার করুন।

কোডের নমুনা ব্রাউজ করুন

  1. 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 স্যাম্পলটি চালায় এবং ব্যবহারের নির্দেশাবলী প্রিন্ট করে: 

    python3 samples/audiences/ingest_audience_members.py --help

কিছু নমুনা ডেটা দিয়ে কাজ শুরু করার জন্য, samples/sampledata ফোল্ডারের ফাইলগুলো ব্যবহার করুন।

রুবি

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

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

পরবর্তী পদক্ষেপ

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