Method: advertisers.reachForecast.retrievePlannableProducts

কোনো একটি স্থানের জন্য পরিকল্পনা করা যেতে পারে এমন পণ্যগুলির তালিকা পুনরুদ্ধার করে।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableProducts

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

পথের পরামিতি

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

string ( int64 format)

পরিকল্পনাযোগ্য পণ্য তালিকাভুক্ত করার জন্য বিজ্ঞাপনদাতার আইডি প্রয়োজন।

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

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

string

প্রয়োজনীয়। পরিকল্পনাযোগ্য স্থানের আইডি।

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

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

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

reachForecast.retrievePlannableProducts-এর জন্য প্রতিক্রিয়া

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

JSON উপস্থাপনা 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
ক্ষেত্র
productMetadata[]

object ( ProductMetadata )

শুধুমাত্র আউটপুট। পণ্যের মেটাডেটার তালিকা, যা টার্গেট করার সম্ভাবনাগুলো দেখাচ্ছে।

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

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

  • https://www.googleapis.com/auth/display-video

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

পণ্যের মেটাডেটা

পরিকল্পনাযোগ্য পণ্যের মেটাডেটা।

JSON উপস্থাপনা 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
ক্ষেত্র
plannableProductDescription

string

শুধুমাত্র আউটপুট। বিজ্ঞাপনের পণ্যটির সাধারণ পাঠ্য বিবরণ।

plannableProductCode

string

শুধুমাত্র আউটপুট। পরিকল্পনাযোগ্য পণ্যের কোড (যেমন "YOUTUBE_REACH_MIX")।

plannableTargeting

object ( PlannableTargeting )

শুধুমাত্র আউটপুট। এই পণ্যের জন্য উপলব্ধ টার্গেটিং সক্ষমতা।

displayName

string

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির সাথে যুক্ত নাম। উদাহরণস্বরূপ: 'ভিডিও ভিউ ক্যাম্পেইন'।

plannableProductCoreAttributes

object ( PlannableProductCoreAttributes )

শুধুমাত্র আউটপুট। এই পণ্যটির মূল বৈশিষ্ট্যসমূহ।

পরিকল্পনাযোগ্য লক্ষ্য নির্ধারণ

একটি নির্দিষ্ট পণ্যের জন্য লক্ষ্য নির্ধারণের সক্ষমতা।

JSON উপস্থাপনা 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
ক্ষেত্র
ageRanges[]

enum ( PlannableAgeRange )

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

surfaceTargetingCombinations

object ( SurfaceTargetingCombinations )

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির জন্য লক্ষ্যযোগ্য পৃষ্ঠতলের সংমিশ্রণ।

genders[]

enum ( Gender )

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির জন্য নির্দিষ্ট লিঙ্গসমূহকে লক্ষ্য করা যাবে।

networks[]

enum ( PlannableNetwork )

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির জন্য লক্ষ্যযোগ্য নেটওয়ার্কসমূহ।

devices[]

enum ( DeviceType )

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির জন্য লক্ষ্যযোগ্য ডিভাইসসমূহ।

youtubeSelectLineups[]

object ( YouTubeSelectLineUp )

শুধুমাত্র আউটপুট। বিজ্ঞাপন পণ্যটির জন্য টার্গেটযোগ্য ইউটিউব সিলেক্ট লাইনআপ।

defaultYoutubeSelectLineup

object ( YouTubeSelectLineUp )

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

পৃষ্ঠতল লক্ষ্য নির্ধারণ সংমিশ্রণ

পৃষ্ঠতলে লক্ষ্যবস্তু নির্ধারণের নিয়মাবলী।

JSON উপস্থাপনা 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
ক্ষেত্র
availableSurfaceTypes[]

enum ( PlannableSurface )

শুধুমাত্র আউটপুট। উপলব্ধ পৃষ্ঠতলের প্রকারভেদ।

validSurfaceCombinations[]

object ( SurfaceTargetingCombination )

শুধুমাত্র আউটপুট। পৃষ্ঠতলগুলির বৈধ সংমিশ্রণ যা একসাথে নির্বাচন করা যেতে পারে।

defaultSurfaceTypes[]

enum ( PlannableSurface )

শুধুমাত্র আউটপুট। এই পণ্যের জন্য ডিফল্ট সারফেস টাইপগুলো।

পৃষ্ঠতল লক্ষ্য নির্ধারণ সংমিশ্রণ

পৃষ্ঠতলগুলোর একটি বৈধ সমন্বয়।

JSON উপস্থাপনা 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
ক্ষেত্র
choices[]

enum ( PlannableSurface )

শুধুমাত্র আউটপুট। পৃষ্ঠতলগুলোর সমন্বয়।

ইউটিউব সিলেক্ট লাইনআপ

পণ্য টার্গেট করার জন্য একটি পরিকল্পনাযোগ্য ইউটিউব সিলেক্ট লাইনআপ।

JSON উপস্থাপনা 
{
  "lineupId": string,
  "displayName": string
}
ক্ষেত্র
lineupId

string ( int64 format)

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

displayName

string

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

পরিকল্পনাযোগ্য পণ্যের মূল বৈশিষ্ট্য

পরিকল্পনাযোগ্য পণ্যের মূল বৈশিষ্ট্যসমূহ।

JSON উপস্থাপনা 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
ক্ষেত্র
productCategory

enum ( PlannableProductCategory )

শুধুমাত্র আউটপুট। পণ্যের বিভাগ।

buyingMethod

enum ( PlannableBuyingMethod )

শুধুমাত্র আউটপুট। ক্রয় পদ্ধতি।

costModel

enum ( PlannableCostModel )

শুধুমাত্র আউটপুট। ব্যয় মডেল।

পরিকল্পনাযোগ্য ক্রয় পদ্ধতি

পরিকল্পনাযোগ্য পণ্যের ক্রয় পদ্ধতি।

এনাম
PLANNABLE_BUYING_METHOD_UNSPECIFIED নির্দিষ্ট করা হয়নি।
PLANNABLE_BUYING_METHOD_AUCTION নিলাম।
PLANNABLE_BUYING_METHOD_RESERVATION সংরক্ষণ।

পরিকল্পনাযোগ্য ব্যয় মডেল

পরিকল্পনাযোগ্য পণ্যের ব্যয় মডেল।

এনাম
PLANNABLE_COST_MODEL_UNSPECIFIED নির্দিষ্ট করা হয়নি।
PLANNABLE_COST_MODEL_CPM সিপিএম।
PLANNABLE_COST_MODEL_CPV সিপিভি।
PLANNABLE_COST_MODEL_CPC সিপিসি।
PLANNABLE_COST_MODEL_CPA সিপিএ।