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

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

পূর্বশর্ত

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

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

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

বিশ্রাম

আপনি যে ধরণের সেটআপ প্রক্রিয়া অনুসরণ করতে চান তা চয়ন করুন:

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

    #!/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
    
    { "গন্তব্য": [ { "অপারেটিং অ্যাকাউন্ট": { "অ্যাকাউন্ট টাইপ": " OPERATING_ACCOUNT_TYPE ", "অ্যাকাউন্ট আইডি": " OPERATING_ACCOUNT_ID " }, "লগইন অ্যাকাউন্ট": { "অ্যাকাউন্ট টাইপ": " LOGIN_ACCOUNT_TYPE ", "অ্যাকাউন্ট আইডি": " LOGIN_ACCOUNT_ID " }, "প্রোডাক্ট ডেস্টিনেশন আইডি": " AUDIENCE_ID " } ], "শ্রোতা সদস্য": [ { "userData": { "userIdentifiers": [ { "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3" }, { "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7" } } }, { "userData": { "userIdentifiers": [": "emailAd "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3" }, { "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51" }, { "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478" } ] } }, { "userData": { "userIdentifiers": [ { "emailAddress "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0" }, { "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5" } ] } }, { "userData": { "userIdentifiers": [ { "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f" }, { "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4" } ] } ], "সম্মতি": { "adUserData": "CONSENT_GRANTED", "adPersonalization": "CONSENT_GRANTED" }, "এনকোডিং": "HEX", "termsOfService": { "customerMatchTermsOfServiceStatus": "ACCEPTED" }, "শুধুমাত্র বৈধ করুন": true }
    
    EOF
    

.নেট

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

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

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

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

    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 সাবডিরেক্টরিতে অথবা GitHub-এ কোড নমুনা ব্রাউজ করুন।

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

    dotnet run
    

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

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

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

জাভা

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

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

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

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

    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 এন্ট্রি যোগ করে ডেটা ম্যানেজার 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 সাবডিরেক্টরিতে অথবা GitHub-এ কোড নমুনা ব্রাউজ করুন। নিম্নলিখিত ধাপগুলি ব্যবহার করে নমুনাগুলি চালান:

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

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

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

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

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

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

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

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

পাইথন

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

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

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

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

    git clone https://github.com/googleads/data-manager-python.git
    
  2. data-manager-python ডিরেক্টরিতে যান।

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

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

    google-ads-data-manager-util=0.2.0
    
  5. ডেটা ফরম্যাট এবং এনক্রিপ্ট করতে, আপনার পাইথন প্রকল্পে Formatter এবং Encrypter ইউটিলিটি ব্যবহার করুন।

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

    pip install .[samples]
    

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

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

রুবি

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

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

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