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

বিশ্রাম

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

3. অনুরোধটি পাঠানোর জন্য নমুনাটি কমান্ড লাইনে কপি করুন।

   যদি আপনি একটি প্রতিষ্ঠিত পণ্য লিঙ্ক ব্যবহার করে operatingAccount অ্যাক্সেস না করেন, তাহলে destinations প্রবেশের linkedAccount বৈশিষ্ট্যটি সরিয়ে ফেলুন।

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account, the command that specifies
   # --scopes fails. 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": [
       {
         "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
   

.নেট

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

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

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

1. data-manager-dotnet.tar.gz ডাউনলোড করে এক্সট্র্যাক্ট করুন।

2. আপনার .NET প্রজেক্টে, ইউটিলিটি লাইব্রেরির উপর একটি ProjectReference নির্ভরতা ঘোষণা করুন। PATH_TO_UTILITY_LIBRARY সেই অবস্থান দিয়ে প্রতিস্থাপন করুন যেখানে আপনি data-manager-dotnet ডিরেক্টরিটি data-manager-dotnet.tar.gz থেকে বের করেছেন।

   <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
   

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

4. samples সাবডিরেক্টরিতে কোড নমুনা ব্রাউজ করুন।

   samples ডিরেক্টরিতে যান এবং উপলব্ধ নমুনার তালিকা পেতে dotnet run ব্যবহার করুন।

   dotnet run
   

   প্রত্যাশিত প্যারামিটার সহ একটি ব্যবহার বিবৃতি প্রিন্ট করার জন্য একটি নমুনা চালানোর সময় --help আর্গুমেন্টটি পাস করুন।

   dotnet run -- ingest-audience-members --help
   

   কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করার জন্য, samples/sampledata/audience_members_1.csv ফাইলটি ব্যবহার করুন।

জাভা

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

1. google-cloud-ads-datamanager-v1-java.tar.gz ডাউনলোড করে এক্সট্র্যাক্ট করুন।
2. google-cloud-ads-datamanager-v1-java ডিরেক্টরিতে যান।

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

   ./gradlew install
   

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

   গ্রেডল:

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

   মাভেন:

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

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

1. GitHub রিপোজিটরি ক্লোন করুন।

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

2. data-manager-java ডিরেক্টরিতে যান।

3. আপনার স্থানীয় 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 সাবডিরেক্টরিতে অথবা GitHub-এ কোড নমুনা ব্রাউজ করুন। কমান্ড লাইন থেকে একটি নমুনা চালাতে, 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-nodejs.tar.gz ডাউনলোড করে এক্সট্র্যাক্ট করুন।
2. ads-datamanager-v1-nodejs ডিরেক্টরিতে যান।

3. npm এর সাথে ব্যবহারের জন্য ক্লায়েন্ট লাইব্রেরিটি কম্পাইল এবং .tgz ফাইলে প্যাক করতে নিম্নলিখিত কমান্ডটি চালান।

   npm pack
   

   এই কমান্ডটি google-cloud-datamanager-0.1.4.tgz নামে একটি আর্কাইভ তৈরি করে। পরবর্তী ধাপে এটি ব্যবহার করার জন্য ফাইলের অবস্থানটি নোট করুন।

4. আপনার Node.js প্রজেক্টে, google-cloud-datamanager-0.1.4.tgz ফাইলের সম্পূর্ণ পাথ এবং ফাইলের নামের জন্য একটি dependencies এন্ট্রি যোগ করে ডেটা ম্যানেজার API ক্লায়েন্ট লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।

   {
      "dependencies": {
         ...
         "@google-cloud/datamanager": "file:PATH_TO_CLIENT_LIBRARY/google-cloud-datamanager-0.1.4.tgz",
         ...
      }
   }
   

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

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

3. util ডিরেক্টরিতে পরিবর্তন করুন।

   cd util
   

4. npm এর সাথে ব্যবহারের জন্য একটি .tgz ফাইলে ইউটিলিটি লাইব্রেরি কম্পাইল এবং প্যাক করতে নিম্নলিখিত কমান্ডটি চালান।

   npm pack
   

   এই কমান্ডটি google-ads-datamanager-util-0.1.0.tgz নামে একটি আর্কাইভ তৈরি করে। পরবর্তী ধাপে এটি ব্যবহার করার জন্য ফাইলের অবস্থানটি নোট করুন।

5. আপনার Node.js প্রজেক্টে, google-ads-datamanager-util-0.1.0.tgz ফাইলের সম্পূর্ণ পাথ এবং ফাইলের নামের জন্য একটি dependencies এন্ট্রি যোগ করে ডেটা ম্যানেজার API ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন।

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.1.0.tgz",
         ...
      }
   }
   

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

6. samples সাবডিরেক্টরিতে কোড নমুনা ব্রাউজ করুন। নিম্নলিখিত ধাপগুলি ব্যবহার করে নমুনাগুলি চালান:

   1. google-cloud-datamanager-0.1.4.tgz ফাইলটি data-manager-node ডিরেক্টরির প্যারেন্ট ডিরেক্টরিতে কপি করুন।

   2. data-manager-node অধীনে samples ডিরেক্টরিতে নেভিগেট করুন।

   3. নমুনাগুলি কম্পাইল করতে নিম্নলিখিত কমান্ডটি চালান।

      npm run compile
      

   4. প্রয়োজনীয় আর্গুমেন্ট পাস করে স্যাম্পলগুলি চালান। প্রত্যাশিত প্যারামিটার সহ একটি ব্যবহার বিবৃতি প্রিন্ট করার জন্য একটি স্যাম্পল চালানোর সময় --help আর্গুমেন্টটি পাস করুন।

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

      npx ts-node audiences/ingest_audience_members.ts --help
      

   কিছু নমুনা ডেটা দিয়ে শুরু করতে সাহায্য করার জন্য, samples/sampledata/audience_members_1.csv ফাইলটি ব্যবহার করুন।

পিএইচপি

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

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. google-cloud-ads-datamanager-v1-php ডিরেক্টরির অবস্থান নির্দেশ করে এমন একটি repositories বিভাগ যোগ করুন।

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

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

      "require": {
         "googleads/data-manager": "0.1.4"
      }
      

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

1. data-manager-php.tar.gz ডাউনলোড করে এক্সট্র্যাক্ট করুন।
2. data-manager-php ডিরেক্টরিতে যান।

3. লাইব্রেরির নির্ভরতা সমাধান করতে নিম্নলিখিত কমান্ডটি চালান:

   composer update --prefer-dist
   

4. একই হোস্টে থাকা আপনার PHP প্রজেক্টের 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 ফাইলটি ব্যবহার করুন।

পাইথন

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

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

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

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

রুবি

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

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