The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

API অ্যাক্সেস সেট আপ করুন

একটি SDK বা REST দিয়ে ডেটা ম্যানেজার API-এ কীভাবে অ্যাক্সেস সেট আপ করবেন তা এখানে।

পূর্বশর্ত

আপনি ডেটা API ব্যবহার করার আগে, নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিতগুলি রয়েছে:

একটি Google ক্লাউড প্রকল্প ।
একটি Google অ্যাকাউন্ট যা নিম্নলিখিত উভয় মানদণ্ড পূরণ করে:
1. আপনি ডেটা ম্যানেজার API আগ্রহের ফর্ম পূরণ করার পরে, ডেটা ম্যানেজার API-তে অ্যাক্সেস দেওয়া হয়েছে। আপনি যদি API পণ্যের বিশদ পৃষ্ঠাটি দেখতে পান তবে আপনার অ্যাক্সেস থাকবে।
2. আপনার Google ক্লাউড প্রোজেক্টে serviceusage.services.enable অনুমতি আছে, অথবা সেই অনুমতিটি অন্তর্ভুক্ত করে এমন একটি ভূমিকা রয়েছে৷ উদাহরণস্বরূপ, roles/owner এবং roles/serviceusage.serviceUsageAdmin উভয়ই serviceusage.services.enable অনুমতি অন্তর্ভুক্ত করে। আপনার অনুমতি পরীক্ষা করতে, বর্তমান অ্যাক্সেস দেখুন দেখুন।

API সক্ষম করুন

যদি আপনি ইতিমধ্যেই না করে থাকেন তবে ডেটা ম্যানেজার API সক্ষম করুন ৷

আপনি যদি ডেটা ম্যানেজার API খুঁজে না পান, আপনার Google অ্যাকাউন্ট পূর্বশর্তগুলি পূরণ করে তা যাচাই করুন৷

প্রমাণীকরণ সেট আপ করুন

একটি প্রমাণীকরণ পদ্ধতি নির্বাচন করুন এবং সেট আপ করুন। আমরা সুপারিশ করি যে আপনি পরিবেশ থেকে স্বয়ংক্রিয়ভাবে শংসাপত্রগুলি খুঁজে পেতে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রগুলি সেট আপ করুন ৷ এই API API কী ব্যবহার করে না।

ডেটা ম্যানেজার API-এর সাথে ব্যবহার করা যেকোনো প্রমাণপত্রের জন্য https://www.googleapis.com/auth/datamanager স্কোপ প্রয়োজন। কিভাবে স্কোপ ব্যবহার করতে হয় তার উদাহরণের জন্য, gcloud auth অ্যাপ্লিকেশন-ডিফল্ট লগইন কমান্ডের ডকুমেন্টেশন দেখুন।

আপনার অ্যাপের প্রমাণীকরণ এবং শংসাপত্র সম্পর্কে আরও জানতে, Google-এ প্রমাণীকরণ পদ্ধতি এবং অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র কীভাবে কাজ করে তা দেখুন।

অপারেটিং অ্যাকাউন্ট অ্যাক্সেস সেট আপ করুন

আপনার ব্যবহারকারী বা পরিষেবা অ্যাকাউন্টের সাথে যুক্ত ইমেলটিকে Destination অ্যাক্সেস দিন।

আপনার প্রোগ্রামিং ভাষার জন্য SDK সেট আপ করুন

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

বিশ্রাম

নিম্নলিখিত নমুনায় স্থানধারক আপডেট করুন, যেমন OPERATING_ACCOUNT_PRODUCT , OPERATING_ACCOUNT_ID , এবং AUDIENCE_ID আপনার অ্যাকাউন্ট এবং গন্তব্যের মান সহ।
আপনার Google ক্লাউডের ID দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

অনুরোধ পাঠাতে কমান্ড লাইনে নমুনা অনুলিপি করুন।

যদি আপনি একটি প্রতিষ্ঠিত পণ্য লিঙ্ক ব্যবহার করে operationAccount অ্যাক্সেস না করেন তবে destinations এন্ট্রির linkedAccount অ্যাট্রিবিউটটি সরান৷

#!/bin/bash

# Uses gcloud to get an access token.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)"

# 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": {
        "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

জাভা

google-cloud-ads-datamanager-v1-java.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
google-cloud-ads-datamanager-v1-java ডিরেক্টরিতে নেভিগেট করুন।
Maven বা Gradle এর সাথে ব্যবহারের জন্য আপনার স্থানীয় Maven সংগ্রহস্থলে লাইব্রেরি তৈরি এবং প্রকাশ করতে নিম্নলিখিত কমান্ডটি চালান।
```
./gradlew -Pversion=0.1.0 install
```

আপনার জাভা প্রকল্পে, ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।

গ্রেডল:

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

মাভেন:

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

ঐচ্ছিক ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।
1. GitHub সংগ্রহস্থল ক্লোন করুন।
```
git clone https://github.com/googleads/data-manager-java.git
```
2. data-manager-java ডিরেক্টরিতে নেভিগেট করুন।
3. আপনার স্থানীয় মাভেন সংগ্রহস্থলে ইউটিলিটি লাইব্রেরি তৈরি করুন এবং প্রকাশ করুন।
```
./gradlew data-manager-util:install
```
4. আপনার জাভা প্রকল্পে, ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।
  গ্রেডল:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  মাভেন:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. ডেটা ফর্ম্যাট এবং এনক্রিপ্ট করতে, আপনার জাভা প্রকল্পে UserDataFormatter এবং Encrypter ইউটিলিটিগুলি ব্যবহার করুন।
6. data-manager-samples সাবডিরেক্টরিতে বা GitHub-এ কোডের নমুনাগুলি ব্রাউজ করুন। কমান্ড লাইন থেকে একটি নমুনা চালানোর জন্য, Gradle run টাস্ক ব্যবহার করুন।
  উদাহরণস্বরূপ, নিম্নলিখিত কমান্ডটি IngestAudienceMembers নমুনা চালায় এবং একটি ব্যবহার বিবৃতি প্রিন্ট করে:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করতে, data-manager-samples/src/main/resources/sampledata/audience_members_1.csv এ ফাইলটি ব্যবহার করুন।

পাইথন

ads-datamanager-v1-py.tar.gz ডাউনলোড করুন।
ডাউনলোডের ডিরেক্টরিতে নেভিগেট করুন।
লাইব্রেরি তৈরি করতে নিম্নলিখিত কমান্ডটি চালান এবং একই পাইথন পরিবেশে অন্যান্য প্রকল্পগুলিতে এটি উপলব্ধ করুন:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
আপনার পাইথন প্রকল্পে, ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন। উদাহরণস্বরূপ, যদি আপনার প্রকল্পে একটি requirements.txt ফাইল ব্যবহার করেন, তাহলে ফাইলটিতে নিম্নলিখিত লাইনটি যোগ করুন:
```
google-ads-data-manager=0.1.0
```
ঐচ্ছিক ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।
1. ডাটা-ম্যানেজার-python.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
2. data-manager-python ডিরেক্টরিতে নেভিগেট করুন।
3. আপনার পাইথন পরিবেশে ইউটিলিটি লাইব্রেরি ইনস্টল করতে, নিম্নলিখিত কমান্ডটি চালান:
```
pip install .
```
4. আপনার পাইথন প্রকল্পে, ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন। উদাহরণস্বরূপ, যদি আপনার প্রকল্পে একটি requirements.txt ফাইল ব্যবহার করেন, তাহলে ফাইলটিতে নিম্নলিখিত লাইনটি যোগ করুন:
```
google-ads-data-manager-util=0.1.0
```
5. ডেটা ফর্ম্যাট এবং এনক্রিপ্ট করতে, আপনার পাইথন প্রকল্পে Formatter এবং Encrypter ইউটিলিটিগুলি ব্যবহার করুন।
6. samples সাবডিরেক্টরিতে কোড নমুনা ব্রাউজ করুন. প্রত্যাশিত পরামিতি সহ একটি ব্যবহার বিবৃতি প্রিন্ট করতে একটি নমুনা চালানোর সময় --help আর্গুমেন্টটি পাস করুন।
  কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করতে, samples/sampledata/audience_members_1.csv এ ফাইলটি ব্যবহার করুন।

Node.js

ads-datamanager-v1-nodejs.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
ads-datamanager-v1-nodejs ডিরেক্টরিতে নেভিগেট করুন।
npm সাথে ব্যবহারের জন্য লাইব্রেরিটিকে একটি .tgz ফাইলে কম্পাইল এবং প্যাক করতে নিম্নলিখিত কমান্ডগুলি চালান।
```
npm install
npm pack
```
কমান্ডগুলি google-cloud-datamanager-0.1.0.tgz নামে একটি সংরক্ষণাগার তৈরি করে।
আপনার Node.js প্রজেক্টে, google-cloud-datamanager-0.1.0.tgz ফাইলের সম্পূর্ণ পাথ এবং ফাইলের জন্য একটি dependencies এন্ট্রি যোগ করে ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।

পিএইচপি

google-cloud-ads-datamanager-v1-php.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
google-cloud-ads-datamanager-v1-php ডিরেক্টরিতে নেভিগেট করুন।
লাইব্রেরির জন্য নির্ভরতা সমাধান করতে নিম্নলিখিত কমান্ডটি চালান:
```
composer update --prefer-dist
```
একই হোস্টে আপনার পিএইচপি প্রকল্পের composer.json ফাইলে, নিম্নলিখিত পদক্ষেপগুলি ব্যবহার করে ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন:
1. একটি repositories বিভাগ যোগ করুন যা google-cloud-ads-datamanager-v1-php ডিরেক্টরির অবস্থান নির্দেশ করে।
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_CLIENT_LIBRARY"
   }
]
```
2. ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।
```
"require": {
   "googleads/data-manager": "^0.1.0"
}
```
(ঐচ্ছিক) ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।
1. ডাটা ম্যানেজার-php.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
2. data-manager-php ডিরেক্টরিতে নেভিগেট করুন।
3. লাইব্রেরির জন্য নির্ভরতা সমাধান করতে নিম্নলিখিত কমান্ডটি চালান:
```
composer update --prefer-dist
```
4. একই হোস্টে আপনার পিএইচপি প্রকল্পের composer.json ফাইলে, নিম্নলিখিত পদক্ষেপগুলি ব্যবহার করে ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন:
  1. repositories বিভাগে একটি এন্ট্রি যোগ করুন যা data-manager-php ডিরেক্টরির অবস্থান নির্দেশ করে।
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
  2. ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
  ডেটা ফর্ম্যাট করতে, আপনার পিএইচপি প্রকল্পে Formatter ইউটিলিটি ব্যবহার করুন।
5. samples সাবডিরেক্টরিতে কোড নমুনা ব্রাউজ করুন. নিম্নলিখিত পদক্ষেপগুলি ব্যবহার করে নমুনাগুলি চালান:
  1. samples ডিরেক্টরিতে নেভিগেট করুন।
  2. DATA_MANAGER_PHP_LIB এনভায়রনমেন্ট ভেরিয়েবলকে সেই পাথে সেট করুন যেখানে আপনি ক্লায়েন্ট লাইব্রেরি বের করেছেন।
```
export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"
```
  3. লাইব্রেরির জন্য নির্ভরতা সমাধান করতে নিম্নলিখিত কমান্ডটি চালান:
```
composer update --prefer-dist
```
  4. নমুনা চালান, কোনো প্রয়োজনীয় আর্গুমেন্ট পাস. প্রত্যাশিত পরামিতি সহ একটি ব্যবহার বিবৃতি প্রিন্ট করতে একটি নমুনা চালানোর সময় --help আর্গুমেন্টটি পাস করুন।
  কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করতে, samples/sampledata/audience_members_1.csv এ ফাইলটি ব্যবহার করুন।