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

ক্লায়েন্ট লাইব্রেরি বা 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": [
    {
      "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

    ডেটা পার্টনার 

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

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

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

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

  1. গিটহাব রিপোজিটরিটি ক্লোন করুন।

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

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

    <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. গিটহাব রিপোজিটরিটি ক্লোন করুন।

    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.2.0'

    ম্যাভেন: 

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

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

  6. data-manager-samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন। কমান্ড লাইন থেকে কোনো নমুনা চালানোর জন্য, গ্রেডল run টাস্কটি ব্যবহার করুন।

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

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

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

নোড.জেএস

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

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

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

  1. গিটহাব রিপোজিটরিটি ক্লোন করুন। 

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

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

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

    npm install

  4. util ডিরেক্টরিতে যান। 

    cd util

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

    npm pack

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

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

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

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

  7. samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন। নিচের ধাপগুলো অনুসরণ করে নমুনাগুলো চালান:

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

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

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

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

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

পিএইচপি

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

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

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

  1. গিটহাব রিপোজিটরিটি ক্লোন করুন। 

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

  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"
}

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

  5. samples সাবডিরেক্টরিতে অথবা গিটহাবে কোডের নমুনাগুলো ব্রাউজ করুন। নিচের ধাপগুলো অনুসরণ করে নমুনাগুলো চালান:

    1. samples ডিরেক্টরিতে যান।

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

      composer update --prefer-dist

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

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

পাইথন

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

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

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

  1. গিটহাব রিপোজিটরিটি ক্লোন করুন। 

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

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

  3. আপনার পাইথন পরিবেশে ইউটিলিটি লাইব্রেরিটি ইনস্টল করতে, নিম্নলিখিত কমান্ডটি চালান: 

    pip install .

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

    google-ads-datamanager-util=0.2.0

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

  6. samples সাবডিরেক্টরিতে অথবা গিটহাবে কোড স্যাম্পলগুলো ব্রাউজ করুন। স্যাম্পলগুলো চালানোর জন্য, প্রয়োজনীয় ডিপেন্ডেন্সিগুলো ইনস্টল করুন: 

    pip install .[samples]

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

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

রুবি

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

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

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

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