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

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

যদি আপনি একটি প্রতিষ্ঠিত পণ্য লিঙ্ক ব্যবহার করে 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

google-cloud-ads-datamanager-v1-csharp.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।

আপনার .NET প্রকল্পে, ডেটা ম্যানেজার API লাইব্রেরিতে একটি ProjectReference নির্ভরতা ঘোষণা করুন। আপনি google-cloud-ads-datamanager-v1-csharp google-cloud-ads-datamanager-v1-csharp.tar.gz csharp ডিরেক্টরিটি যে অবস্থান থেকে বের করেছেন সেখানে PATH_TO_CLIENT_LIBRARY প্রতিস্থাপন করুন।

<ProjectReference Include="PATH_TO_CLIENT_LIBRARY\Google.Ads.DataManager.V1\Google.Ads.DataManager.V1.csproj" />

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

1. ডাটা-ম্যানেজার-dotnet.tar.gz ডাউনলোড এবং এক্সট্রাক্ট করুন।

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

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

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

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

   কোডের নমুনাগুলি চালানোর জন্য, DATA_MANAGER_DOTNET_LIB এনভায়রনমেন্ট ভেরিয়েবলকে সেই অবস্থানে সেট করুন যেখানে আপনি google-cloud-ads-datamanager-v1-csharp ডিরেক্টরিটি google-cloud-ads-datamanager-v1-csharp.tar.gz থেকে বের করেছেন।

   export DATA_MANAGER_DOTNET_LIB="PATH_TO_CLIENT_LIBRARY"
   

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

   dotnet run --framework net8.0
   

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

   dotnet run --framework net8.0 -- ingest-audience-members --help
   

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

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

./gradlew install

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

গ্রেডল:

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

মাভেন:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.3</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 এ ফাইলটি ব্যবহার করুন।

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

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

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

google-ads-data-manager=0.1.3

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

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

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

npm install
npm pack

কমান্ডগুলি google-cloud-datamanager-0.1.3.tgz নামে একটি সংরক্ষণাগার তৈরি করে।

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

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

composer update --prefer-dist

একই হোস্টে আপনার 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.3"
   }
   

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

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