REST Resource: adUnits

সম্পদ: AdUnit

একটি একক বিজ্ঞাপন ইউনিট।

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "impressionDataRanges": [
    {
      object (ImpressionDataRange)
    }
  ],
  "photoUrls": [
    string
  ],
  "products": [
    string
  ]
}
ক্ষেত্র
name

string

ফরম্যাটে বিজ্ঞাপন ইউনিটের রিসোর্স নাম: adUnits/{id} । উদাহরণস্বরূপ adUnits/adUnit123 ।

externalId

string

ঐচ্ছিক। বিক্রেতা সম্ভবত তাদের নিজস্ব সিস্টেমে আইডি পরিচালনা করে। একবার সেট পরিবর্তন করার সম্ভাবনা নেই। এটি অভ্যন্তরীণভাবে ব্যবহার করা উচিত নয় এবং সীমাবদ্ধতা প্রয়োগ করা হয় না।

displayName

string

প্রয়োজন। বিজ্ঞাপন ইউনিটের প্রদর্শনের নাম।

UTF-8 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

description

string

ঐচ্ছিক। বিজ্ঞাপন ইউনিট বর্ণনা করার জন্য অতিরিক্ত ফ্রিফর্ম ক্ষেত্র।

labels

map (key: string, value: string)

ঐচ্ছিক। এই বিজ্ঞাপন ইউনিটকে বর্ণনা করার জন্য ফ্রিফর্ম লেবেলের সেট।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

attributes[]

enum ( AdUnitAttribute )

ঐচ্ছিক। এই বিজ্ঞাপন ইউনিটকে আরও সংজ্ঞায়িত করার জন্য গুণাবলী।

creatives[]

object ( CreativeSpecification )

ঐচ্ছিক। অনুমোদিত ক্রিয়েটিভের তালিকা যা এই বিজ্ঞাপন ইউনিটের জন্য পরিবেশন করা যেতে পারে। এটি পণ্য স্তরেও সংজ্ঞায়িত করা যেতে পারে।

createTime

string ( Timestamp format)

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

updateTime

string ( Timestamp format)

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

state

enum ( AdUnitState )

শুধুমাত্র আউটপুট। বিজ্ঞাপন ইউনিটের অবস্থা। যদি AD_UNIT_STATE_REJECTED প্রত্যাখ্যাত কারণটিতে কারণ থাকবে।

rejectedReason

string

শুধুমাত্র আউটপুট। অনুমোদন_স্থিতি AD_UNIT_APPROVAL_STATUS_REJECTED হলে এই ক্ষেত্রটিতে কারণ থাকবে।

location

object ( LatLng )

প্রয়োজন। অপরিবর্তনীয়। স্বাক্ষরিত ডিগ্রি বিন্যাসে বিজ্ঞাপন ইউনিটের অক্ষাংশ এবং দ্রাঘিমাংশ।

directionSet

boolean

প্রয়োজন। সঠিক যদি দিকনির্দেশ করা হয়।

direction

integer

ঐচ্ছিক। অপরিবর্তনীয়। উত্তরের সাথে ডিগ্রীতে মূল দিকটি 0। [0-360)।

elevationMetersSet

boolean

প্রয়োজন। উচ্চতা মিটার সেট করা থাকলে সত্য।

elevationMeters

number

ঐচ্ছিক। অপরিবর্তনীয়। বিজ্ঞাপন ইউনিটের নিচ থেকে মাটির দূরত্ব মিটারে।

physicalWidthMetersSet

boolean

প্রয়োজন। ফিজিক্যাল উইডথমিটার সেট করা থাকলে সত্য।

physicalWidthMeters

number

ঐচ্ছিক। অপরিবর্তনীয়। বিজ্ঞাপন ইউনিটের প্রকৃত প্রস্থ মিটারে।

physicalHeightMetersSet

boolean

প্রয়োজন। প্রকৃত উচ্চতা মিটার সেট করা থাকলে সত্য।

physicalHeightMeters

number

ঐচ্ছিক। অপরিবর্তনীয়। মিটারে বিজ্ঞাপন ইউনিটের শারীরিক উচ্চতা।

venue

enum ( OutOfHomeVenue )

ঐচ্ছিক। DPAA মানগুলির উপর ভিত্তি করে বাড়ির বাইরের স্থানের ধরন। এটি একটি তথ্যমূলক ক্ষেত্র যা বিজ্ঞাপনদাতাদের কাছে উপস্থাপন করা যেতে পারে এবং বিজ্ঞাপন ইউনিটগুলিকে ফিল্টার করতেও ব্যবহার করা যেতে পারে।

fixedLocation

boolean

ঐচ্ছিক। বিজ্ঞাপনটি নির্দিষ্ট স্থানে (বিলবোর্ড) হোক বা চলন্ত (ট্যাক্সি) হোক।

indoors

boolean

প্রয়োজন। বিজ্ঞাপন ইউনিট বাড়ির ভিতরে আছে কিনা।

impressionDataRanges[]

object ( ImpressionDataRange )

প্রয়োজন। এই বিজ্ঞাপন ইউনিটের সাথে যুক্ত ইম্প্রেশন ডেটা ব্যাপ্তি। তারিখ ব্যাপ্তি ওভারল্যাপ আশা করা হয় না. বিজ্ঞাপন ইউনিট কেনার জন্য যোগ্য হতে ইম্প্রেশন ডেটা প্রয়োজন।

photoUrls[]

string

ঐচ্ছিক। বিজ্ঞাপন ইউনিটের ফটো ইউআরএল।

products[]

string

প্রয়োজন। এই বিজ্ঞাপন ইউনিটের সাথে যুক্ত পণ্যের সম্পদের নাম ফরম্যাটে: products/{id} । উদাহরণস্বরূপ products/product123 ।

AdUnitAttribute

বিজ্ঞাপন ইউনিটকে আরও সংজ্ঞায়িত করতে ব্যবহৃত সম্ভাব্য বৈশিষ্ট্য।

Enums
AD_UNIT_ATTRIBUTE_UNSPECIFIED ডিফল্ট মান যখন বিজ্ঞাপন ইউনিট অ্যাট্রিবিউট নির্দিষ্ট করা হয় না বা এই সংস্করণে অজানা থাকে।
AD_UNIT_ATTRIBUTE_ILLUMINATED ভৌত জগতে যদি বিজ্ঞাপন ইউনিট অন্ধকারে দৃশ্যমান হয়।
AD_UNIT_ATTRIBUTE_DIGITAL একটি ডিজিটাল বিজ্ঞাপন ইউনিট, ক্লাসিক ফিজিক্যাল অন্তর্ভুক্ত না হলে তা বোঝানো হয়।
AD_UNIT_ATTRIBUTE_PHYSICAL বিজ্ঞাপন ইউনিট ভৌত জগতে একটি বস্তু হিসাবে বিদ্যমান।

AdUnitState

বিক্রেতার দৃষ্টিকোণ থেকে বিজ্ঞাপন ইউনিটের অবস্থা।

Enums
AD_UNIT_STATE_UNSPECIFIED ডিফল্ট মান যখন বিজ্ঞাপন ইউনিট স্টেট নির্দিষ্ট করা হয় না বা এই সংস্করণে অজানা থাকে।
AD_UNIT_STATE_PENDING বিজ্ঞাপন ইউনিট অনুমোদন মুলতুবি আছে.
AD_UNIT_STATE_APPROVED বিজ্ঞাপন ইউনিট অনুমোদিত হয়.
AD_UNIT_STATE_REJECTED বিজ্ঞাপন ইউনিট প্রত্যাখ্যান করা হয়.
AD_UNIT_STATE_DELETED বিজ্ঞাপন ইউনিট মুছে ফেলা হয়েছে.

আউটঅফহোমভেন্যু

DPAA স্ট্যান্ডার্ডের উপর ভিত্তি করে হোম ভেন্যু প্রকারের তালিকা।

Enums
OOH_VENUE_UNSPECIFIED ডিফল্ট মান যখন OOH ভেন্যু নির্দিষ্ট করা হয় না বা এই সংস্করণে অজানা থাকে।
OOH_VENUE_AIRBORNE বাড়ির বাইরে বায়ুবাহিত হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_AIRPORTS_GENERAL বাড়ির বাইরের স্থান বিমানবন্দর সাধারণ হিসাবে শ্রেণীবদ্ধ।
OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM বাড়ির বাইরে বিমানবন্দরের ব্যাগেজ দাবি হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_AIRPORTS_TERMINAL বাড়ির বাইরে বিমানবন্দর টার্মিনাল হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_AIRPORTS_LOUNGES বাড়ির বাইরে বিমানবন্দর লাউঞ্জ হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_ATMS বাড়ির বাইরে এটিএম হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_BACKLIGHTS বাড়ির বাইরে ব্যাকলাইট হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_BARS বাড়ির বাইরে বার হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_BENCHES বাড়ির বাইরে বেঞ্চ হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_BIKE_RACKS বাড়ির বাইরে বাইক র্যাক হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_BULLETINS বাড়ির বাইরে বুলেটিন হিসাবে শ্রেণীবদ্ধ.
OOH_VENUE_BUSES বাড়ির বাইরে বাস হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_CAFES বাড়ির বাইরে ক্যাফে হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_CASUAL_DINING_RESTAURANTS বাড়ির বাইরে নৈমিত্তিক খাবারের রেস্তোরাঁ হিসেবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_CHILD_CARE বাড়ির বাইরে শিশু যত্ন হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_CINEMA বাড়ির বাইরে সিনেমা হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_CITY_INFORMATION_PANELS বাড়ির বাইরে শহরের তথ্য প্যানেল হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_CONVENIENCE_STORES বাড়ির বাইরে সুবিধার দোকান হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_DEDICATED_WILD_POSTING বাড়ির বাইরে ডেডিকেটেড ওয়াইল্ড পোস্টিং হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_DOCTORS_OFFICES_GENERAL হোম ভেন্যুর বাইরে ডাক্তারদের অফিস সাধারণ হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS বাড়ির বাইরে ডাক্তারদের অফিস প্রসূতি হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS বাড়ির বাইরে ডাক্তারদের অফিস পেডিয়াট্রিক্স হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_FAMILY_ENTERTAINMENT বাড়ির বাইরে পারিবারিক বিনোদন হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_FERRIES হোম ভেন্যুর বাইরে ফেরি হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_FINANCIAL_SERVICES বাড়ির বাইরে আর্থিক পরিষেবা হিসাবে শ্রেণীবদ্ধ।
OOH_VENUE_GAS_STATIONS বাড়ির বাইরে গ্যাস স্টেশন হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_GOLF_COURSES বাড়ির বাইরে গল্ফ কোর্স হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_GYMS বাড়ির বাইরে জিম হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_HOSPITALS বাড়ির বাইরে হাসপাতাল হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_HOTELS বাড়ির বাইরে হোটেল হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_JUNIOR_POSTERS বাড়ির বাইরে জুনিয়র পোস্টার হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_KIOSKS বাড়ির বাইরে কিয়স্ক হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_MALLS_GENERAL মল সাধারণ হিসাবে শ্রেণীবদ্ধ হোম ভেন্যু বাইরে.
OOH_VENUE_MALLS_FOOD_COURTS হোম ভেন্যুর বাইরে মল ফুড কোর্ট হিসাবে শ্রেণীবদ্ধ।
OOH_VENUE_MARINE বাড়ির বাইরে সামুদ্রিক হিসাবে শ্রেণীবদ্ধ.
OOH_VENUE_MOBILE_BILLBOARDS বাড়ির বাইরে মোবাইল বিলবোর্ড হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_MOVIE_THEATER_LOBBIES বাড়ির বাইরে সিনেমা থিয়েটার লবি হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_NEWSSTANDS বাড়ির বাইরে নিউজস্ট্যান্ড হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_OFFICE_BUILDINGS বাড়ির বাইরে অফিস ভবন হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_PHONE_KIOSKS বাড়ির বাইরে ফোন কিয়স্ক হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_POSTERS বাড়ির বাইরে পোস্টার হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_QSR বাড়ির বাইরে qsr হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_RAIL বাড়ির বাইরে রেল হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_RECEPTACLES হোম ভেন্যুর বাইরে আধার হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_RESORTS বাড়ির বাইরে রিসর্ট হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_RETAIL বাড়ির বাইরে খুচরা হিসাবে শ্রেণীবদ্ধ.
OOH_VENUE_SALONS বাড়ির বাইরে সেলুন হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_SHELTERS বাড়ির বাইরে আশ্রয়কেন্দ্র হিসেবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_SPORTS_ARENAS বাড়ির বাইরে খেলার আখড়া হিসেবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_SUBWAY বাড়ির বাইরে পাতাল রেল হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_TAXIS বাড়ির বাইরে ট্যাক্সি হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_TRUCKSIDE বাড়ির বাইরে ট্রাকসাইড হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_UNIVERSITIES হোম ভেন্যুর বাইরে বিশ্ববিদ্যালয় হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_URBAN_PANELS বাড়ির বাইরে শহুরে প্যানেল হিসাবে শ্রেণীবদ্ধ করা হয়েছে।
OOH_VENUE_VETERINARIAN_OFFICES বাড়ির বাইরে পশুচিকিত্সক অফিস হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_WALLS বাড়ির বাইরে দেয়াল হিসাবে শ্রেণীবদ্ধ করা হয়েছে.
OOH_VENUE_OTHER বাড়ির বাইরে অন্যান্য হিসাবে শ্রেণীবদ্ধ.

ইমপ্রেশন ডেটা রেঞ্জ

একটি তারিখ ব্যাপ্তির জন্য ইম্প্রেশন ডেটা।

JSON প্রতিনিধিত্ব 
{
  "impressionDataStartTime": string,
  "impressionDataEndTime": string,
  "impressionDataUnits": [
    {
      object (ImpressionDataUnit)
    }
  ]
}
ক্ষেত্র
impressionDataStartTime

string ( Timestamp format)

প্রয়োজন। ব্যবধানের শুরু যখন ইম্প্রেশন ডেটা বৈধ (অন্তর্ভুক্ত)।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

impressionDataEndTime

string ( Timestamp format)

প্রয়োজন। ব্যবধানের সমাপ্তি যখন ইম্প্রেশন ডেটা বৈধ (একচেটিয়া)।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

impressionDataUnits[]

object ( ImpressionDataUnit )

প্রয়োজন। নির্দিষ্ট তারিখ ব্যাপ্তির জন্য ইম্প্রেশন ডেটা।

ইমপ্রেশনডেটা ইউনিট

সপ্তাহের একটি নির্দিষ্ট দিন এবং দিনের ঘন্টার জন্য ইম্প্রেশন ডেটা।

JSON প্রতিনিধিত্ব 
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "impressions": string
}
ক্ষেত্র
dayOfWeek

enum ( DayOfWeek )

প্রয়োজন। সপ্তাহের দিন ইম্প্রেশন ডেটা প্রতিনিধিত্ব করে।

hourOfDay

integer

প্রয়োজন। দিনের ঘন্টা ইম্প্রেশন ডেটা 24 ঘন্টা ফর্ম্যাটে উপস্থাপন করে। 0 থেকে 23 পর্যন্ত হওয়া উচিত।

impressions

string ( int64 format)

প্রয়োজন। দিনের নির্দিষ্ট সময়ে সপ্তাহের নির্দিষ্ট দিনে ইম্প্রেশনের সংখ্যা।

পদ্ধতি

create

 একটি নতুন বিজ্ঞাপন ইউনিট তৈরি করে।

delete

 একটি বিদ্যমান বিজ্ঞাপন ইউনিট মুছে দেয়।

get

 একটি পৃথক বিজ্ঞাপন ইউনিট পুনরুদ্ধার করে।

list

 বিজ্ঞাপন ইউনিট তালিকা.

patch

 একটি বিদ্যমান বিজ্ঞাপন ইউনিট আপডেট করে।