REST Resource: sellers.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,
  "photoUris": [
    string
  ],
  "products": [
    string
  ]
}
फ़ील्ड
name

string

फ़ॉर्मैट में विज्ञापन यूनिट के संसाधन का नाम: sellers/{seller}/adUnits/{adUnit}. उदाहरण के लिए, sellers/seller321/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)

सिर्फ़ आउटपुट के लिए. विज्ञापन यूनिट बनाने के लिए टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. विज्ञापन यूनिट के लिए पिछली बार अपडेट किया गया टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

state

enum (AdUnitState)

सिर्फ़ आउटपुट के लिए. विज्ञापन यूनिट की स्थिति. अगर AD_UNIT_UNIT_REJECTED अस्वीकार कर दिया गया है, तो इसमें वजह शामिल होगी.

rejectedReason

string

सिर्फ़ आउटपुट के लिए. अगर verification_status AD_UNIT_APPROVAL_STATUS_REJECTED है. इस फ़ील्ड में इसकी वजह बताई गई होगी.

location

object (LatLng)

ज़रूरी है. इम्यूटेबल. हस्ताक्षर किए गए डिग्री फ़ॉर्मैट में विज्ञापन यूनिट का अक्षांश और देशांतर.

directionSet

boolean

अगर सही है, तो दिशा फ़ील्ड में दिशा की वैल्यू होगी. अगर गलत है, तो दिशा शून्य होनी चाहिए.

direction

integer

इम्यूटेबल. डिग्री में कार्डिनल दिशा जिसमें उत्तर 0 दिखाता है. [0 से 360 के बीच].

elevationMetersSet

boolean

अगर सही है, तो ऊंचाई फ़ील्ड में मीटर में ऊंचाई शामिल होगी. अगर गलत है, तो ऊंचाई शून्य होनी चाहिए.

elevationMeters

number

इम्यूटेबल. विज्ञापन यूनिट के निचले हिस्से से ज़मीन तक की दूरी, मीटर में.

physicalWidthMetersSet

boolean

अगर 'सही' है, तो परोसने और पाने वालों के फ़ील्ड में मीटर में फ़िज़िकल चौड़ाई शामिल होगी. अगर गलत है, तो FishwidthMeters शून्य होना चाहिए.

physicalWidthMeters

number

इम्यूटेबल. विज्ञापन यूनिट की फ़िज़िकल चौड़ाई, मीटर में.

physicalHeightMetersSet

boolean

अगर सही है, तो FishHightMeters फ़ील्ड में, मीटर में शारीरिक ऊंचाई शामिल की जाएगी. अगर गलत है, तो defaultHightMeters शून्य होना चाहिए.

physicalHeightMeters

number

इम्यूटेबल. विज्ञापन यूनिट की शारीरिक ऊंचाई, मीटर में.

venue

enum (OutOfHomeVenue)

डीपीएए के मानकों के आधार पर, घर से बाहर की जगह की जानकारी. यह जानकारी वाला एक फ़ील्ड है, जिसे विज्ञापन देने वालों को दिखाया जा सकता है. इसका इस्तेमाल विज्ञापन यूनिट को फ़िल्टर करने के लिए भी किया जा सकता है.

fixedLocation

boolean

विज्ञापन एक तय जगह पर है (बिलबोर्ड) या मूविंग (टैक्सी) है.

indoors

boolean

ज़रूरी है. विज्ञापन यूनिट इनडोर है या नहीं.

photoUris[]

string

विज्ञापन यूनिट के फ़ोटो यूआरआई.

products[]

string

ज़रूरी है. इस विज्ञापन यूनिट से जुड़े प्रॉडक्ट के संसाधन नाम: sellers/{seller}/products/{product}. उदाहरण के लिए, sellers/seller111/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 विज्ञापन यूनिट को मिटा दिया गया है.

OutOfHomeVenue

डीपीएए के मानकों के आधार पर, घरेलू मैदान में अलग-अलग तरह की जगहों की सूची.

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 क्यूएसआर की कैटगरी में रखा गया, घरेलू मैदान से बाहर का इलाका.
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 घर से बाहर की जगह को अन्य कैटगरी में रखा गया है.

तरीके

create

नई विज्ञापन यूनिट बनाता है.

delete

मौजूदा विज्ञापन यूनिट को मिटा देता है.

get

व्यक्तिगत विज्ञापन यूनिट को हासिल करता है.

list

यह विज्ञापन यूनिट की सूची बनाता है.

patch

मौजूदा विज्ञापन यूनिट को अपडेट करता है.