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

ক্লায়েন্ট লাইব্রেরি বা REST ইনস্টল এবং কনফিগার করার পদ্ধতি এখানে দেওয়া হলো।

পূর্বশর্ত

ক্লায়েন্ট লাইব্রেরি ইনস্টল করার আগে, অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) কনফিগার করা সহ ‘এপিআই অ্যাক্সেস সেট আপ করুন’ -এর ধাপগুলো সম্পূর্ণ করুন।

ইনস্টলেশনের ধাপগুলি

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

বিশ্রাম

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

  3. Copy the sample to the command line to send the request. Only use the Data partner sample if you're accessing the operating account through a partner link. Otherwise, use the Advertiser sample.

    বিজ্ঞাপনদাতা 

    #!/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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

    Data partner 

    #!/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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

.NET

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

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

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

  1. Clone the GitHub repository .

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

যান

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

go get cloud.google.com/go/datamanager/apiv1@latest

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

জাভা

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

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

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

  1. Clone the GitHub repository .

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

  2. Navigate to the data-manager-java directory.

  3. ইউটিলিটি লাইব্রেরিটি বিল্ড করে আপনার লোকাল মেভেন রিপোজিটরিতে পাবলিশ করুন।

    ./gradlew data-manager-util:install

  4. আপনার জাভা প্রজেক্টে ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন।

    Gradle: 

    implementation 'com.google.api-ads:data-manager-util:0.2.0'

    Maven: 

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

নোড.জেএস

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

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

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

  1. Clone the GitHub repository . 

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

  2. Navigate to the data-manager-node directory.

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

    npm install

  4. Change to the util directory. 

    cd util

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

    npm pack

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

  6. In your Node.js project, declare a dependency on the Data Manager API utility library by adding a dependencies entry for the full path and filename of the google-ads-datamanager-util-0.2.0.tgz file. 

    {
   "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. Navigate to the data-manager-node directory.

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

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

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

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

পিএইচপি

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

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

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

  1. Clone the GitHub repository . 

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

  2. Navigate to the data-manager-php directory.

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

    composer update --prefer-dist

  4. একই হোস্টে থাকা আপনার PHP প্রজেক্টের composer.json ফাইলে, নিম্নলিখিত ধাপগুলো অনুসরণ করে ইউটিলিটি লাইব্রেরির উপর একটি ডিপেন্ডেন্সি ঘোষণা করুন:

    1. Add an entry in the repositories section that points to the location of the data-manager-php directory. 

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

    2. Declare a dependency on the utility library. 

      "require": {
   "googleads/data-manager-util": "@dev"
}

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

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

    1. Navigate to the samples directory.

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

      composer update --prefer-dist

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

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

পাইথন

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

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

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

  1. Clone the GitHub repository . 

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

  2. Navigate to the data-manager-python directory.

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

রুবি

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

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

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

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