Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

একটি ব্যবহারকারী তালিকা গ্লোবাল লাইসেন্সের জন্য সমস্ত গ্রাহকের তথ্য তালিকাভুক্ত করে।

এই ফিচারটি শুধুমাত্র ডেটা পার্টনারদের জন্য উপলব্ধ।

HTTP অনুরোধ

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*/userListGlobalLicenses/*}/userListGlobalLicenseCustomerInfos

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
parent

string

প্রয়োজনীয়। যে গ্লোবাল লাইসেন্সের গ্রাহক তথ্য জানতে চাওয়া হচ্ছে। এটি accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} ফরম্যাটে থাকতে হবে। একটি অ্যাকাউন্টের অধীনে সমস্ত গ্লোবাল লাইসেন্স গ্রাহকের তথ্য তালিকাভুক্ত করতে, ইউজার লিস্ট গ্লোবাল লাইসেন্স আইডি-কে একটি '-' দিয়ে প্রতিস্থাপন করুন (উদাহরণস্বরূপ, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/- )।

কোয়েরি প্যারামিটার

প্যারামিটার
filter

string

ঐচ্ছিক। তালিকার অনুরোধে প্রয়োগ করার জন্য একটি ফিল্টার স্ট্রিং । প্রতিটি শর্তের বাম দিকে সমস্ত ফিল্ড থাকতে হবে (উদাহরণস্বরূপ: user_list_id = 123 )। ফিল্ডগুলি অবশ্যই হয় সম্পূর্ণ ক্যামেল কেস অথবা সম্পূর্ণ স্নেক কেস ব্যবহার করে নির্দিষ্ট করতে হবে। ক্যামেল কেস এবং স্নেক কেসের মিশ্রণ ব্যবহার করবেন না।

সমর্থিত কার্যক্রম:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

সমর্থিত ফাংশনসমূহ: - IN(field, value1, value2, ...) : যদি ফিল্ডটি উল্লিখিত মানগুলোর যেকোনো একটির সাথে মিলে যায়, তবে এটি true রিটার্ন করে। উদাহরণ: IN(user_list_id, 123, 456)

অসমর্থিত ক্ষেত্রসমূহ:

  • name (এর পরিবর্তে get মেথড ব্যবহার করুন)
  • historical_pricings এবং এর সমস্ত উপক্ষেত্র
  • pricing.start_time
  • pricing.end_time
pageSize

integer

ঐচ্ছিক। ফেরত দেওয়ার জন্য লাইসেন্সের সর্বোচ্চ সংখ্যা। পরিষেবাটি এই মানের চেয়ে কমও ফেরত দিতে পারে। যদি নির্দিষ্ট না করা হয়, তবে সর্বাধিক ৫০টি লাইসেন্স ফেরত দেওয়া হবে। সর্বোচ্চ মান হলো ১০০০; ১০০০-এর উপরের মানগুলোকে ১০০০-এ রূপান্তরিত করা হবে।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী ListUserListDirectLicense কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পেজটি পুনরুদ্ধার করতে এটি প্রদান করুন।

পেজিনেশন করার সময়, ListUserListDirectLicense এ প্রদত্ত অন্য সকল প্যারামিটার অবশ্যই সেই কলের সাথে মিলতে হবে যা পেজ টোকেনটি প্রদান করেছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

[ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest] থেকে প্রাপ্ত প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
userListGlobalLicenseCustomerInfos[]

object ( UserListGlobalLicenseCustomerInfo )

অনুরোধে প্রদত্ত লাইসেন্সের জন্য গ্রাহকের তথ্য।

nextPageToken

string

একটি টোকেন, যা পরবর্তী পৃষ্ঠা আনার জন্য pageToken হিসেবে পাঠানো যেতে পারে। এই ক্ষেত্রটি বাদ দিলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/datamanager

ব্যবহারকারীর তালিকা গ্লোবাল লাইসেন্স গ্রাহকের তথ্য

ব্যবহারকারী তালিকার গ্লোবাল লাইসেন্সের গ্রাহকের তথ্য। কোনো গ্রাহক গ্লোবাল লাইসেন্স ক্রয় করলে সিস্টেম দ্বারা এটি স্বয়ংক্রিয়ভাবে তৈরি হবে।

JSON উপস্থাপনা 
{
  "name": string,
  "userListId": string,
  "userListDisplayName": string,
  "licenseType": enum (UserListGlobalLicenseType),
  "status": enum (UserListLicenseStatus),
  "pricing": {
    object (UserListLicensePricing)
  },
  "clientAccountType": enum (UserListLicenseClientAccountType),
  "clientAccountId": string,
  "clientAccountDisplayName": string,
  "historicalPricings": [
    {
      object (UserListLicensePricing)
    }
  ],
  "metrics": {
    object (UserListLicenseMetrics)
  }
}
ক্ষেত্র
name

string

শনাক্তকারী। ব্যবহারকারী তালিকার বৈশ্বিক লাইসেন্স গ্রাহকের রিসোর্স নাম।

userListId

string ( int64 format)

শুধুমাত্র আউটপুট। লাইসেন্স করা হচ্ছে এমন ব্যবহারকারী তালিকার আইডি।

userListDisplayName

string

শুধুমাত্র আউটপুট। লাইসেন্স প্রদান করা হচ্ছে এমন ব্যবহারকারী তালিকার নাম।

licenseType

enum ( UserListGlobalLicenseType )

শুধুমাত্র আউটপুট। ক্লায়েন্ট গ্রাহকের পণ্যের ধরণ, যেটিকে ব্যবহারকারী তালিকাটি লাইসেন্স করা হচ্ছে।

status

enum ( UserListLicenseStatus )

শুধুমাত্র আউটপুট। UserListDirectLicense-এর অবস্থা - সক্রিয় (ENABLED) অথবা নিষ্ক্রিয় (DISABLED)।

pricing

object ( UserListLicensePricing )

শুধুমাত্র আউটপুট। UserListDirectLicense-এর মূল্য নির্ধারণ।

clientAccountType

enum ( UserListLicenseClientAccountType )

শুধুমাত্র আউটপুট। ক্লায়েন্ট গ্রাহকের পণ্যের ধরণ, যেটিকে ব্যবহারকারী তালিকাটি লাইসেন্স করা হচ্ছে।

clientAccountId

string ( int64 format)

শুধুমাত্র আউটপুট। ক্লায়েন্ট গ্রাহকের আইডি, যাকে ব্যবহারকারী তালিকাটি লাইসেন্স করা হচ্ছে।

clientAccountDisplayName

string

শুধুমাত্র আউটপুট। ক্লায়েন্টের নাম, যাকে ব্যবহারকারী তালিকাটি লাইসেন্স করা হচ্ছে।

historicalPricings[]

object ( UserListLicensePricing )

শুধুমাত্র আউটপুট। এই ব্যবহারকারী তালিকা লাইসেন্সের মূল্য নির্ধারণের ইতিহাস।

metrics

object ( UserListLicenseMetrics )

শুধুমাত্র আউটপুট। এই লাইসেন্স সম্পর্কিত মেট্রিক্স।

userListGlobalLicenseCustomerInfos.list কলে শুরু এবং শেষের তারিখ সেট করা হলেই কেবল এই ফিল্ডটি পূরণ করা হয়।