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

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

পূর্বশর্ত

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

ইনস্টল করার ধাপ

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

বিশ্রাম

  1. নিম্নলিখিত স্যাম্পেলে প্লেসহোল্ডার আপডেট করুন, যেমন OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID এবং AUDIENCE_ID, আপনার অ্যাকাউন্ট ও গন্তব্যের ভ্যালু সহ।
  2. PROJECT_ID-এর জায়গায় আপনার Google Cloud-এর আইডি লিখুন।
  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": [
        {
          "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
    

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

    #!/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. আপনার .NET প্রোজেক্টে, Google.Ads.DataManager.Util ইউটিলিটি লাইব্রেরির উপর ডিপেনডেন্সি ঘোষণা করুন।

    dotnet add package Google.Ads.DataManager.Util --version 0.4.0
    
  2. ডেটা ফর্ম্যাট করতে, আপনার .NET প্রোজেক্টে UserDataFormatter ইউটিলিটি ব্যবহার করুন।

কোড স্যাম্পেল ব্রাউজ করুন

samples সাবডিরেক্টরি বা GitHub-এ কোড স্যাম্পেল ব্রাউজ করুন।

স্যাম্পেল রান করতে:

  1. v0.4.0 ট্যাগে GitHub রিপোজিটরি ক্লোন করুন:

    git clone --branch v0.4.0 https://github.com/googleads/data-manager-dotnet.git
    
  2. data-manager-dotnet ডিরেক্টরিতে নেভিগেট করুন।

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

    dotnet run
    

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

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

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

খুলুন

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

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

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

Java

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

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

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন

ক্লায়েন্ট লাইব্রেরি ছাড়াও, আপনি ইউটিলিটি লাইব্রেরি ইনস্টল করতে পারেন, যা ইনজেশনের জন্য ডেটা ফর্ম্যাট ও এনক্রিপ্ট করার মতো সাধারণ কাজে সাহায্য করে।

  1. আপনার Java প্রোজেক্টে, data-manager-util ইউটিলিটি লাইব্রেরির উপর ডিপেন্ডেন্সি ঘোষণা করুন।

    Gradle:

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

    Maven:

    <dependency>
       <groupId>com.google.api-ads</groupId>
       <artifactId>data-manager-util</artifactId>
       <version>0.4.0</version>
    </dependency>
    
  2. ডেটা ফর্ম্যাট ও এনক্রিপ্ট করতে, আপনার Java প্রোজেক্টে UserDataFormatter এবং Encrypter ইউটিলিটি ব্যবহার করুন।

কোড স্যাম্পেল ব্রাউজ করুন

data-manager-samples সাবডিরেক্টরি বা GitHub-এ কোড স্যাম্পেল ব্রাউজ করুন।

স্যাম্পেল রান করতে:

  1. v0.4.0 ট্যাগে GitHub রিপোজিটরি ক্লোন করুন:

    git clone --branch v0.4.0 https://github.com/googleads/data-manager-java.git
    
  2. data-manager-java ডিরেক্টরিতে নেভিগেট করুন।

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

    যেমন, নিম্নলিখিত কমান্ড IngestAudienceMembers স্যাম্পেল রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

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

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

Node.js

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

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

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন

ক্লায়েন্ট লাইব্রেরি ছাড়াও, আপনি ইউটিলিটি লাইব্রেরি ইনস্টল করতে পারেন যাতে ইনজেশনের জন্য ডেটা ফর্ম্যাট করার মতো সাধারণ কাজে সাহায্য পাওয়া যায়।

  1. আপনার Node.js প্রোজেক্টে, @google-ads/datamanager-util ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন:

    npm install @google-ads/datamanager-util
    
  2. ডেটা ফর্ম্যাট করতে, আপনার Node.js প্রোজেক্টে UserDataFormatter ইউটিলিটি ব্যবহার করুন।

কোড স্যাম্পেল ব্রাউজ করুন

samples সাবডিরেক্টরি বা GitHub-এ কোড স্যাম্পেল ব্রাউজ করুন।

স্যাম্পেল রান করতে:

  1. v0.4.1 ট্যাগে GitHub রিপোজিটরি ক্লোন করুন:

    git clone --branch v0.4.1 https://github.com/googleads/data-manager-node.git
    
  2. data-manager-node ডিরেক্টরিতে নেভিগেট করুন।

  3. স্যাম্পেল চালানোর জন্য ডিপেন্ডেন্সি ইনস্টল করুন:

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

    যেমন, নিম্নলিখিত কমান্ড ingest-audience-members স্যাম্পেল রান করে এবং ব্যবহারের স্টেটমেন্ট প্রিন্ট করে:

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

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

PHP

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

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

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন

ক্লায়েন্ট লাইব্রেরি ছাড়াও, আপনি ইউটিলিটি লাইব্রেরি ইনস্টল করতে পারেন যাতে ইনজেশনের জন্য ডেটা ফর্ম্যাট করার মতো সাধারণ কাজে সাহায্য পাওয়া যায়।

  1. একই হোস্টে আপনার PHP প্রোজেক্টের composer.json ফাইলে, ইউটিলিটি লাইব্রেরির উপর নির্ভরতা ঘোষণা করুন:

    composer require googleads/data-manager-util
    
  2. ডেটা ফর্ম্যাট করতে, আপনার PHP প্রোজেক্টে Formatter ইউটিলিটি ব্যবহার করুন।

কোড স্যাম্পেল ব্রাউজ করুন

samples সাবডিরেক্টরি বা GitHub-এ কোড স্যাম্পেল ব্রাউজ করুন।

স্যাম্পেল রান করতে:

  1. v0.4.0 ট্যাগে GitHub রিপোজিটরি ক্লোন করুন:

    git clone --branch v0.4.0 https://github.com/googleads/data-manager-php.git
    
  2. data-manager-php/samples ডিরেক্টরিতে নেভিগেট করুন।

  3. স্যাম্পেল চালানোর জন্য ডিপেন্ডেন্সি ইনস্টল করুন:

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

    যেমন, নিম্নলিখিত কমান্ড ingest_audience_members স্যাম্পেল রান করে এবং ব্যবহারের স্টেটমেন্ট প্রিন্ট করে:

    php audiences/ingest_audience_members.php --help
    

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

Python

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

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

ঐচ্ছিক: ইউটিলিটি লাইব্রেরি ইনস্টল করুন

ক্লায়েন্ট লাইব্রেরি ছাড়াও, আপনি ইউটিলিটি লাইব্রেরি ইনস্টল করতে পারেন, যা ইনজেশনের জন্য ডেটা ফর্ম্যাট ও এনক্রিপ্ট করার মতো সাধারণ কাজে সাহায্য করে।

  1. আপনার Python প্রোজেক্টে, google-ads-datamanager-util ইউটিলিটি লাইব্রেরির উপর ডিপেন্ডেন্সি ঘোষণা করুন।

    যেমন, আপনার প্রোজেক্টে requirements.txt ফাইল ব্যবহার করলে, ফাইলে নিম্নলিখিত লাইন যোগ করুন:

    google-ads-datamanager-util==0.4.0
    

    অথবা সরাসরি ইউটিলিটি লাইব্রেরি ইনস্টল করুন:

    pip install google-ads-datamanager-util==0.4.0
    
  2. ডেটা ফর্ম্যাট ও এনক্রিপ্ট করতে, আপনার Python প্রোজেক্টে Formatter এবং Encrypter ইউটিলিটি ব্যবহার করুন।

কোড স্যাম্পেল ব্রাউজ করুন

  1. v0.4.0 ট্যাগে GitHub রিপোজিটরি ক্লোন করুন:

    git clone --branch v0.4.0 https://github.com/googleads/data-manager-python.git
    
  2. data-manager-python ডিরেক্টরিতে নেভিগেট করুন।

  3. স্যাম্পেল চালানোর জন্য ডিপেন্ডেন্সি ইনস্টল করুন:

    pip install -r samples/requirements.txt
    
  4. প্রয়োজনীয় আর্গুমেন্ট পাস করে স্যাম্পেল রান করুন। প্রত্যাশিত প্যারামিটার সহ ব্যবহারের বিবৃতি প্রিন্ট করার জন্য স্যাম্পেল চালানোর সময় --help আর্গুমেন্ট পাস করুন।

    যেমন, নিম্নলিখিত কমান্ড ingest_audience_members স্যাম্পেল রান করে এবং ব্যবহারের বিবৃতি প্রিন্ট করে:

    python3 samples/audiences/ingest_audience_members.py --help
    

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

Ruby

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

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

পরবর্তী ধাপ