REST Resource: accountTypes.accounts.userLists

রিসোর্স: ব্যবহারকারীর তালিকা

ব্যবহারকারী তালিকার একটি রিসোর্স।

JSON উপস্থাপনা 
{
  "name": string,
  "id": string,
  "readOnly": boolean,
  "membershipDuration": string,
  "accessReason": enum (AccessReason),
  "sizeInfo": {
    object (SizeInfo)
  },
  "targetNetworkInfo": {
    object (TargetNetworkInfo)
  },
  "displayName": string,
  "description": string,
  "membershipStatus": enum (MembershipStatus),
  "integrationCode": string,
  "closingReason": enum (ClosingReason),
  "accountAccessStatus": enum (AccessStatus),

  // Union field user_list_info can be only one of the following:
  "ingestedUserListInfo": {
    object (IngestedUserListInfo)
  }
  // End of list of possible types for union field user_list_info.
}
ক্ষেত্র
name

string

শনাক্তকারী। ব্যবহারকারী তালিকার রিসোর্স নাম। ফরম্যাট: accountTypes/{accountType}/accounts/{account}/userLists/{userList}

id

string ( int64 format)

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার অনন্য আইডি।

readOnly

boolean

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

membershipDuration

string ( Duration format)

ঐচ্ছিক। একজন ব্যবহারকারী কতক্ষণ ব্যবহারকারী তালিকায় থাকবেন। বৈধ সময়কাল হলো ২৪ ঘন্টার (৮৬৪০০ সেকেন্ড) সঠিক গুণিতক। এমন কোনো মান প্রদান করলে যা ২৪ ঘন্টার সঠিক গুণিতক নয়, তাহলে একটি INVALID_ARGUMENT ত্রুটি দেখা দেবে।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

accessReason

enum ( AccessReason )

শুধুমাত্র আউটপুট। এই অ্যাকাউন্টটিকে তালিকাটিতে প্রবেশাধিকার দেওয়ার কারণ।

sizeInfo

object ( SizeInfo )

শুধুমাত্র আউটপুট। বিভিন্ন টার্গেট নেটওয়ার্কে এই ব্যবহারকারী তালিকার আনুমানিক সদস্য সংখ্যা।

targetNetworkInfo

object ( TargetNetworkInfo )

ঐচ্ছিক। বিভিন্ন লক্ষ্য নেটওয়ার্কের জন্য যোগ্যতার তথ্য।

displayName

string

আবশ্যক। ব্যবহারকারী তালিকার প্রদর্শিত নাম।

description

string

ঐচ্ছিক। ব্যবহারকারী তালিকার বিবরণ।

membershipStatus

enum ( MembershipStatus )

ঐচ্ছিক। এই ব্যবহারকারী তালিকার সদস্যপদ স্থিতি।

integrationCode

string

ঐচ্ছিক। বাহ্যিক সিস্টেম থেকে প্রাপ্ত একটি আইডি। ব্যবহারকারী তালিকা বিক্রেতারা তাদের সিস্টেমে আইডিগুলোর মধ্যে সামঞ্জস্য বিধান করতে এটি ব্যবহার করেন।

closingReason

enum ( ClosingReason )

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

accountAccessStatus

enum ( AccessStatus )

ঐচ্ছিক। এই শেয়ারটি এখনও সক্রিয় আছে কিনা তা নির্দেশ করে। যখন কোনো ব্যবহারকারী তালিকা অ্যাকাউন্টের সাথে শেয়ার করা হয়, তখন এই ফিল্ডটি ENABLED হিসেবে সেট করা হয়। পরবর্তীতে ব্যবহারকারী তালিকার মালিক শেয়ারটি প্রত্যাহার করে এটিকে DISABLED করার সিদ্ধান্ত নিতে পারেন।

ইউনিয়ন ফিল্ড user_list_info । ব্যবহারকারী তালিকা সম্পর্কে অতিরিক্ত তথ্য। user_list_info নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
ingestedUserListInfo

object ( IngestedUserListInfo )

ঐচ্ছিক। এটি এমন একটি ব্যবহারকারী তালিকা উপস্থাপন করে যা ব্যবহারকারীর দেওয়া তথ্য দ্বারা পূরণ করা হয়।

সদস্যপদ স্থিতি

ব্যবহারকারী তালিকার অবস্থা।

এনাম
MEMBERSHIP_STATUS_UNSPECIFIED নির্দিষ্ট করা হয়নি।
OPEN উন্মুক্ত অবস্থা - ব্যবহারকারী তালিকায় নতুন সদস্য যুক্ত হচ্ছে এবং এটিকে লক্ষ্যবস্তু করা যেতে পারে।
CLOSED বন্ধ অবস্থা - কোনো নতুন সদস্য যোগ করা হচ্ছে না।

বন্ধ করার কারণ

ব্যবহারকারী তালিকাটি কেন বন্ধ করা হয়েছিল তার কারণ নির্দেশ করে। এই enum-টি শুধুমাত্র তখনই ব্যবহৃত হয় যখন সিস্টেম দ্বারা কোনো তালিকা স্বয়ংক্রিয়ভাবে বন্ধ করা হয়।

এনাম
CLOSING_REASON_UNSPECIFIED নির্দিষ্ট করা হয়নি।
UNUSED ব্যবহারকারী তালিকাটি বন্ধ করে দেওয়া হয়েছে কারণ এটি সম্প্রতি টার্গেটিং-এ ব্যবহার করা হয়নি। বিস্তারিত জানতে https://support.google.com/google-ads/answer/2472738 দেখুন।

অ্যাক্সেসরিজন

সম্ভাব্য অ্যাক্সেসের কারণগুলি বর্ণনা করে এমন এনাম।

এনাম
ACCESS_REASON_UNSPECIFIED নির্দিষ্ট করা হয়নি।
OWNED সম্পদটির মালিক ব্যবহারকারী।
SHARED রিসোর্সটি ব্যবহারকারীর সাথে শেয়ার করা হয়েছে।
LICENSED এই রিসোর্সটি ব্যবহারকারীকে লাইসেন্স করা হয়েছে।
SUBSCRIBED ব্যবহারকারী রিসোর্সটিতে সাবস্ক্রাইব করেছেন।
AFFILIATED সম্পদটি ব্যবহারকারীর জন্য প্রবেশযোগ্য।

অ্যাক্সেস স্ট্যাটাস

এই ক্লায়েন্টের এখনও তালিকাটিতে প্রবেশাধিকার আছে কিনা তা নির্দেশ করে।

এনাম
ACCESS_STATUS_UNSPECIFIED নির্দিষ্ট করা হয়নি।
ENABLED প্রবেশাধিকার সক্রিয় করা হয়েছে।
DISABLED প্রবেশাধিকার নিষ্ক্রিয় করা হয়েছে।

সাইজইনফো

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

JSON উপস্থাপনা 
{
  "displayNetworkMembersCount": string,
  "searchNetworkMembersCount": string,
  "youtubeMembersCount": string,
  "gmailMembersCount": string
}
ক্ষেত্র
displayNetworkMembersCount

string ( int64 format)

শুধুমাত্র আউটপুট। গুগল ডিসপ্লে নেটওয়ার্কে এই ব্যবহারকারী তালিকার আনুমানিক সদস্য সংখ্যা।

searchNetworkMembersCount

string ( int64 format)

শুধুমাত্র আউটপুট। google.com ডোমেইনে এই ব্যবহারকারী তালিকায় থাকা সদস্যদের আনুমানিক সংখ্যা। এই সদস্যরাই সার্চ ক্যাম্পেইনে টার্গেট করার জন্য উপলব্ধ।

youtubeMembersCount

string ( int64 format)

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

gmailMembersCount

string ( int64 format)

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

টার্গেটনেটওয়ার্কইনফো

বিভিন্ন লক্ষ্য নেটওয়ার্কের জন্য যোগ্যতার তথ্য।

JSON উপস্থাপনা 
{
  "eligibleForDisplay": boolean,
  "eligibleForSearch": boolean
}
ক্ষেত্র
eligibleForDisplay

boolean

শুধুমাত্র আউটপুট। এটি নির্দেশ করে যে এই ব্যবহারকারী তালিকাটি গুগল ডিসপ্লে নেটওয়ার্কের জন্য যোগ্য।

ইনজেস্টেডইউজারলিস্টইনফো

এটি এমন একটি ব্যবহারকারী তালিকা যা ব্যবহারকারীর দেওয়া তথ্য দ্বারা পূরণ করা হয়।

JSON উপস্থাপনা 
{
  "uploadKeyTypes": [
    enum (UploadKeyType)
  ],
  "contactIdInfo": {
    object (ContactIdInfo)
  },
  "mobileIdInfo": {
    object (MobileIdInfo)
  },
  "userIdInfo": {
    object (UserIdInfo)
  },
  "pairIdInfo": {
    object (PairIdInfo)
  },
  "pseudonymousIdInfo": {
    object (PseudonymousIdInfo)
  },
  "partnerAudienceInfo": {
    object (PartnerAudienceInfo)
  }
}
ক্ষেত্র
uploadKeyTypes[]

enum ( UploadKeyType )

আবশ্যক। অপরিবর্তনীয়। এই ব্যবহারকারী তালিকার মূল প্রকারগুলি আপলোড করুন।

contactIdInfo

object ( ContactIdInfo )

ঐচ্ছিক। CONTACT_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

mobileIdInfo

object ( MobileIdInfo )

ঐচ্ছিক। যখন MOBILE_ID uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

userIdInfo

object ( UserIdInfo )

ঐচ্ছিক। USER_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

pairIdInfo

object ( PairIdInfo )

ঐচ্ছিক। PAIR_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

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

pseudonymousIdInfo

object ( PseudonymousIdInfo )

ঐচ্ছিক। PSEUDONYMOUS_ID এর জন্য অতিরিক্ত তথ্য হলো uploadKeyTypes গুলোর মধ্যে একটি।

partnerAudienceInfo

object ( PartnerAudienceInfo )

ঐচ্ছিক। অংশীদার দর্শকদের জন্য অতিরিক্ত তথ্য।

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

আপলোড কী টাইপ

একটি ব্যবহারকারী তালিকার সম্ভাব্য আপলোড কী-এর প্রকারগুলো ধারণকারী এনাম।

এনাম
UPLOAD_KEY_TYPE_UNSPECIFIED নির্দিষ্ট করা হয়নি।
CONTACT_ID গ্রাহকের তথ্য যেমন ইমেল ঠিকানা, ফোন নম্বর বা ঠিকানা।
MOBILE_ID মোবাইল বিজ্ঞাপনের আইডি।
USER_ID তৃতীয় পক্ষ কর্তৃক প্রদত্ত ইউজার আইডি।
PAIR_ID প্রকাশক ও বিজ্ঞাপনদাতার পরিচয় সমন্বয় আইডি।
PSEUDONYMOUS_ID ডেটা ম্যানেজমেন্ট প্ল্যাটফর্ম আইডি: - গুগল ইউজার আইডি - পার্টনার প্রদত্ত আইডি - পাবলিশার প্রদত্ত আইডি - আইওএস আইডিএফএ - অ্যান্ড্রয়েড বিজ্ঞাপন আইডি - রোকু আইডি - অ্যামাজন ফায়ার টিভি আইডি - এক্সবক্স বা মাইক্রোসফট আইডি

যোগাযোগের তথ্য

CONTACT_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

JSON উপস্থাপনা 
{
  "matchRatePercentage": integer,
  "dataSourceType": enum (DataSourceType)
}
ক্ষেত্র
matchRatePercentage

integer

শুধুমাত্র আউটপুট। গ্রাহক ও ব্যবহারকারী তালিকার জন্য মিলের হার।

dataSourceType

enum ( DataSourceType )

ঐচ্ছিক। অপরিবর্তনীয়। আপলোড ডেটার উৎস।

ডেটা উৎসের ধরণ

আপলোড ডেটার উৎস নির্দেশ করে।

এনাম
DATA_SOURCE_TYPE_UNSPECIFIED নির্দিষ্ট করা হয়নি।
DATA_SOURCE_TYPE_FIRST_PARTY আপলোড করা ডেটা হলো ফার্স্ট-পার্টি ডেটা।
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU আপলোড করা ডেটা একটি তৃতীয় পক্ষের ক্রেডিট ব্যুরো থেকে নেওয়া হয়েছে।
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE আপলোড করা তথ্যটি একটি তৃতীয় পক্ষের ভোটার ফাইল থেকে নেওয়া হয়েছে।
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA আপলোড করা ডেটাটি তৃতীয় পক্ষের অংশীদারের ডেটা।

মোবাইলআইডিইনফো

যখন MOBILE_ID uploadKeyTypes গুলোর মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

JSON উপস্থাপনা 
{
  "dataSourceType": enum (DataSourceType),
  "keySpace": enum (KeySpace),
  "appId": string
}
ক্ষেত্র
dataSourceType

enum ( DataSourceType )

ঐচ্ছিক। অপরিবর্তনীয়। আপলোড ডেটার উৎস।

keySpace

enum ( KeySpace )

আবশ্যক। অপরিবর্তনীয়। মোবাইল আইডির মূল অংশ।

appId

string

আবশ্যক। অপরিবর্তনীয়। একটি স্ট্রিং যা সেই মোবাইল অ্যাপ্লিকেশনটিকে অনন্যভাবে শনাক্ত করে যেখান থেকে ডেটা সংগ্রহ করা হয়েছে।

কীস্পেস

মোবাইল আইডির জন্য কী-স্পেস।

এনাম
KEY_SPACE_UNSPECIFIED নির্দিষ্ট করা হয়নি।
IOS iOS কীস্পেস।
ANDROID অ্যান্ড্রয়েড কীস্পেস।

ব্যবহারকারীর আইডি তথ্য

USER_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

JSON উপস্থাপনা 
{
  "dataSourceType": enum (DataSourceType)
}
ক্ষেত্র
dataSourceType

enum ( DataSourceType )

ঐচ্ছিক। অপরিবর্তনীয়। আপলোড ডেটার উৎস।

জোড়া আইডি তথ্য

PAIR_ID যখন uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

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

JSON উপস্থাপনা 
{
  "publisherId": string,
  "publisherName": string,
  "matchRatePercentage": integer,
  "advertiserIdentifierCount": string,
  "cleanRoomIdentifier": string
}
ক্ষেত্র
publisherId

string ( int64 format)

আবশ্যক। অপরিবর্তনীয়। এটি সেই প্রকাশককে শনাক্ত করে যার সাথে 'প্রকাশক বিজ্ঞাপনদাতা পরিচয় সমন্বয়' ব্যবহারকারী তালিকাটি সমন্বয় করা হয়। এই ক্ষেত্রটি ক্লিনরুম প্রদানকারী দ্বারা সরবরাহ করা হয় এবং এটি শুধুমাত্র সেই ক্লিনরুমের পরিধির মধ্যেই অনন্য। এটি একাধিক ক্লিনরুম জুড়ে একটি বৈশ্বিক শনাক্তকারী হিসাবে ব্যবহার করা যাবে না।

publisherName

string

আবশ্যক। উন্নততর টার্গেটিং অভিজ্ঞতার জন্য ইউআই-তে প্রকাশকের একটি বর্ণনামূলক নাম প্রদর্শন করতে হবে।

matchRatePercentage

integer

আবশ্যক। এই ফিল্ডটি সংশ্লিষ্ট প্রকাশকের ফার্স্ট পার্টি ডেটার সাথে এই ব্যবহারকারী তালিকার সদস্যপদ মিলের শতাংশ নির্দেশ করে। এর মান অবশ্যই ০ থেকে ১০০-এর মধ্যে হতে হবে।

advertiserIdentifierCount

string ( int64 format)

ঐচ্ছিক। বিজ্ঞাপনদাতার ফার্স্ট পার্টি ডেটা রেকর্ডের সংখ্যা যা একটি ক্লিন রুম প্রোভাইডারের কাছে আপলোড করা হয়েছে। এটি PAIR ব্যবহারকারী তালিকার আকার নির্দেশ করে না।

cleanRoomIdentifier

string

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

ছদ্মনামযুক্ত আইডি তথ্য

যখন PSEUDONYMOUS_ID uploadKeyTypes মধ্যে একটি হয়, তখন অতিরিক্ত তথ্য।

JSON উপস্থাপনা 
{
  "syncStatus": enum (SyncStatus),
  "billableRecordCount": string
}
ক্ষেত্র
syncStatus

enum ( SyncStatus )

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার অবস্থা সিঙ্ক করুন।

billableRecordCount

string ( int64 format)

ঐচ্ছিক। অপরিবর্তনীয়। বিলযোগ্য রেকর্ডের সংখ্যা (যেমন আপলোড করা বা মেলানো)।

সিঙ্কস্ট্যাটাস

ব্যবহারকারী তালিকার অবস্থা সিঙ্ক করুন।

এনাম
SYNC_STATUS_UNSPECIFIED নির্দিষ্ট করা হয়নি।
CREATED ব্যবহারকারী তালিকাটি একটি প্লেসহোল্ডার হিসেবে তৈরি করা হয়েছে। তালিকার বিষয়বস্তু এবং/অথবা মেটাডেটা এখনও সিঙ্ক করা হচ্ছে। ব্যবহারকারী তালিকাটি ব্যবহারের জন্য প্রস্তুত নয়।
READY_FOR_USE ব্যবহারকারী তালিকাটি ব্যবহারের জন্য প্রস্তুত। বিষয়বস্তু এবং কুকি সঠিকভাবে সিঙ্ক করা হয়েছে।
FAILED ব্যবহারকারী তালিকার বিষয়বস্তু এবং/অথবা মেটাডেটা সিঙ্ক করার সময় একটি ত্রুটি ঘটেছে। ব্যবহারকারী তালিকাটি ব্যবহার করা যাবে না।

পার্টনারঅডিয়েন্সইনফো

অংশীদার দর্শকদের জন্য অতিরিক্ত তথ্য।

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

JSON উপস্থাপনা 
{
  "partnerAudienceSource": enum (PartnerAudienceSource),
  "commercePartner": string
}
ক্ষেত্র
partnerAudienceSource

enum ( PartnerAudienceSource )

আবশ্যক। অপরিবর্তনীয়। অংশীদার দর্শকগোষ্ঠীর উৎস।

commercePartner

string

ঐচ্ছিক। বাণিজ্যিক অংশীদারের নাম। শুধুমাত্র তখনই অনুমোদিত, যদি partnerAudienceSource COMMERCE_AUDIENCE হয়।

পার্টনারঅডিয়েন্সসোর্স

সহযোগী দর্শক উৎস।

এনাম
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED নির্দিষ্ট করা হয়নি।
COMMERCE_AUDIENCE পার্টনার অডিয়েন্সের উৎস হলো কমার্স অডিয়েন্স।
LINEAR_TV_AUDIENCE পার্টনার অডিয়েন্সের উৎস হলো লিনিয়ার টিভি দর্শক।
AGENCY_PROVIDER_AUDIENCE পার্টনার অডিয়েন্সের উৎস হলো এজেন্সি/প্রোভাইডার অডিয়েন্স।

পদ্ধতি

create

 একটি ব্যবহারকারী তালিকা তৈরি করে।

delete

 একটি ব্যবহারকারী তালিকা মুছে ফেলে।

get

 একটি ব্যবহারকারী তালিকা পায়।

list

 ব্যবহারকারীর তালিকাগুলো তালিকাভুক্ত করে।

patch

 ব্যবহারকারী তালিকা হালনাগাদ করে।