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

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

Google ক্লাউড কমান্ড লাইন ইন্টারফেস সেট আপ করুন

1. Google ক্লাউড কমান্ড লাইন ইন্টারফেস ইনস্টল এবং আরম্ভ করুন ।

2. আপনার gcloud উপাদানগুলি আপ টু ডেট আছে তা নিশ্চিত করতে, নিম্নলিখিত কমান্ডটি চালান।

   gcloud components update
   

3. (ঐচ্ছিক) একটি ডিফল্ট প্রকল্প এবং অঞ্চল সেট করতে gcloud config set কমান্ড ব্যবহার করুন।

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

আপনি ব্যবহারকারীর অ্যাকাউন্ট এবং পরিষেবা অ্যাকাউন্টগুলির সাথে প্রমাণীকরণ করতে পারেন:

• ব্যবহারকারীর অ্যাকাউন্ট : যারা সরাসরি Google API এবং পরিষেবাগুলির সাথে ইন্টারঅ্যাক্ট করে তাদের প্রতিনিধিত্ব করে৷
• পরিষেবা অ্যাকাউন্ট : ব্যবহারকারী হিসাবে অ্যাপগুলিকে প্রতিনিধিত্ব করুন, মানুষ নয়। তারা আপনার অ্যাপগুলিকে প্রমাণীকরণ এবং অনুমোদন পরিচালনা করতে দেয়। উদাহরণস্বরূপ, যদি একটি অ্যাপের Google ক্লাউড সংস্থান অ্যাক্সেস করতে হয়।

আপনার ইন্টিগ্রেশন পরিবেশ থেকে স্বয়ংক্রিয়ভাবে শংসাপত্রগুলি খুঁজে পেতে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) ব্যবহার করতে পারে। প্রমাণীকরণের জন্য আপনাকে ক্লায়েন্ট কোড পরিবর্তন করতে হবে না।

ADC সেট আপ করতে ব্যবহারকারী অ্যাকাউন্ট বা পরিষেবা অ্যাকাউন্ট চয়ন করুন:

ব্যবহারকারীর অ্যাকাউন্ট পরিষেবা অ্যাকাউন্ট

দ্রষ্টব্য: ডেটা ম্যানেজার API-এর সাথে ব্যবহৃত যেকোনও শংসাপত্রের জন্য https://www.googleapis.com/auth/datamanager সুযোগ প্রয়োজন।

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

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

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

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

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

বিশ্রাম

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

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
   

জাভা

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. আপনার জাভা প্রকল্পে, ডেটা ম্যানেজার 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>
   

5. ঐচ্ছিক ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।

   1. ডাটা-ম্যানেজার-java.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।
   2. data-manager-java ডিরেক্টরিতে নেভিগেট করুন।

   3. Maven বা Gradle এর জন্য, নিম্নলিখিত কমান্ডটি চালান। এই কমান্ডটি আপনার স্থানীয় Maven সংগ্রহস্থলে ইউটিলিটি লাইব্রেরি তৈরি করে এবং প্রকাশ করে।

      ./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 সাবডিরেক্টরিতে কোডের নমুনাগুলি ব্রাউজ করুন। কমান্ড লাইন থেকে একটি নমুনা চালানোর জন্য, Gradle run টাস্ক ব্যবহার করুন।

      উদাহরণস্বরূপ, নিম্নলিখিত কমান্ডটি IngestAudienceMembers নমুনা চালায় এবং একটি ব্যবহার বিবৃতি প্রিন্ট করে:

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

      কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করতে, data-manager-samples/src/main/resources/sampledata/audience_members_1.csv এ ফাইলটি ব্যবহার করুন।

পাইথন

1. ads-datamanager-v1-py.tar.gz ডাউনলোড করুন।
2. ডাউনলোডের ডিরেক্টরিতে নেভিগেট করুন।

3. লাইব্রেরি তৈরি করতে নিম্নলিখিত কমান্ডটি চালান এবং একই পাইথন পরিবেশে অন্যান্য প্রকল্পগুলিতে এটি উপলব্ধ করুন:

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

4. আপনার পাইথন প্রকল্পে, ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন। উদাহরণস্বরূপ, যদি আপনার প্রকল্পে একটি requirements.txt ফাইল ব্যবহার করেন, তাহলে ফাইলটিতে নিম্নলিখিত লাইনটি যোগ করুন:

   google-ads-data-manager=0.1.0
   

5. ঐচ্ছিক ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।

   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

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 এন্ট্রি যোগ করে ডেটা ম্যানেজার API লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।

পিএইচপি

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 ফাইলে, নিম্নলিখিত পদক্ষেপগুলি ব্যবহার করে ডেটা ম্যানেজার 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"
      }
      

5. (ঐচ্ছিক) ইউটিলিটি লাইব্রেরি এবং কোড নমুনা পান।

   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 এ ফাইলটি ব্যবহার করুন।