REST Resource: accounts.locations.media

रिसॉर्स: MediaItem

एक मीडिया आइटम.

JSON के काेड में दिखाना
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड
name

string

इस मीडिया आइटम के लिए संसाधन का नाम. accounts/{accountId}/locations/{locationId}/media/{mediaKey} अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

mediaFormat

enum (MediaFormat)

इस मीडिया आइटम का फ़ॉर्मैट. मीडिया आइटम बनाते समय सेट होना चाहिए और अन्य सभी अनुरोधों पर केवल पढ़ने के लिए होता है. अपडेट नहीं किया जा सका.

locationAssociation

object (LocationAssociation)

CreatePhoto पर कॉल करते समय ज़रूरी है. यह बताता है कि यह मीडिया आइटम अपनी जगह से कैसे कनेक्ट है. यह या तो कोई कैटगरी (उदाहरण के लिए, EXTERIOR) या कीमत वाली सूची के आइटम का आईडी होना चाहिए.

media.create वाली जगह के लिए नया मीडिया जोड़ते समय यह ज़रूरी है. अन्य तरह के मीडिया (जैसे कि स्थानीय पोस्ट में मौजूद फ़ोटो) के लिए, यह जानकारी मौजूद नहीं होगी.

googleUrl

string

सिर्फ़ आउटपुट के लिए. इस मीडिया आइटम के लिए Google की ओर से होस्ट किया गया यूआरएल. यह यूआरएल स्थिर नहीं है, क्योंकि यह समय के साथ बदल सकता है. वीडियो के लिए यह ओवरले के साथ चलाएं आइकॉन के साथ झलक इमेज होगी.

thumbnailUrl

string

सिर्फ़ आउटपुट के लिए. जहां इस मीडिया आइटम की थंबनेल इमेज का यूआरएल दिया जाता है.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस मीडिया आइटम को बनाए जाने का समय.

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

dimensions

object (Dimensions)

सिर्फ़ आउटपुट के लिए. पिक्सल में डाइमेंशन (चौड़ाई और ऊंचाई).

insights

object (MediaInsights)

सिर्फ़ आउटपुट के लिए. इस मीडिया आइटम के आंकड़े.

attribution

object (Attribution)

सिर्फ़ आउटपुट के लिए. ग्राहक मीडिया आइटम के एट्रिब्यूशन की जानकारी. आपको यह एट्रिब्यूशन वही तरीके से दिखाना चाहिए जो आपके उपयोगकर्ताओं को दिया गया है. साथ ही, आपको न तो एट्रिब्यूशन को मिटाना चाहिए और न ही उसमें बदलाव करना चाहिए.

description

string

इस मीडिया आइटम के बारे में जानकारी. Google My Business API का इस्तेमाल करके ब्यौरे में बदलाव नहीं किया जा सकता. हालांकि, इसे ऐसे नया मीडिया आइटम बनाते समय सेट किया जा सकता है जो कवर फ़ोटो न हो.

यूनियन फ़ील्ड data. मीडिया आइटम का डेटा सोर्स. नया मीडिया आइटम बनाते समय, यूआरएल या डेटा का रेफ़रंस देना ज़रूरी है.

PROFILE और COVER कैटगरी को छोड़कर, बाकी सभी फ़ोटो का साइज़ कम से कम 250 पिक्सल होना चाहिए. साथ ही, फ़ाइल का साइज़ कम से कम 10240 बाइट होना चाहिए.

अपलोड की गई सभी फ़ोटो, फ़ोटो के लिए Business Profile के दिशा-निर्देशों के मुताबिक होनी चाहिए. data इनमें से सिर्फ़ एक हो सकता है:

sourceUrl

string

सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला ऐसा यूआरएल जहां से मीडिया आइटम को वापस लाया जा सकता है.

इसे या dataRef को बनाते समय, मीडिया आइटम का सोर्स बताने के लिए आपको इसे सेट करना होगा.

अगर मीडिया आइटम बनाते समय sourceUrl का इस्तेमाल किया गया था, तो मीडिया आइटम को वापस लाने पर, उसका सोर्स यूआरएल अपने-आप भर जाएगा.

इस फ़ील्ड को अपडेट नहीं किया जा सकता.

dataRef

object (MediaItemDataRef)

सिर्फ़ इनपुट. मीडिया आइटम बाइनरी डेटा का रेफ़रंस, जो media.startUpload तरीके से मिलता है.

मीडिया आइटम बनाते समय, इनमें से कोई एक काम करें

sourceUrl

या

dataRef

सेट होना चाहिए.

MediaItemDataRef

Google My Business API की मदद से अपलोड किए गए MediaItem के फ़ोटो बाइनरी डेटा का रेफ़रंस.

media.startUpload का इस्तेमाल करके डेटा रेफ़रंस बनाएं. साथ ही, [media.upload] पर बाइट अपलोड करने और फिर media.create को कॉल करने के दौरान, इस रेफ़रंस का इस्तेमाल करें.

JSON के काेड में दिखाना
{
  "resourceName": string
}
फ़ील्ड
resourceName

string

इस मीडिया आइटम के बाइनरी डेटा का यूनीक आईडी. इसका इस्तेमाल [media.upload] के साथ फ़ोटो डेटा को अपलोड करने के लिए किया जाता है. साथ ही, media.create का इस्तेमाल करके, चुनी गई बाइट से नया मीडिया आइटम बनाते समय भी इसका इस्तेमाल किया जाता है.

बाइट अपलोड करने का उदाहरण: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

media.create कॉल के लिए, इसे MediaItem dataRef के तौर पर सेट करें.

MediaFormat

मीडिया फ़ॉर्मैट के लिए Enum.

Enums
MEDIA_FORMAT_UNSPECIFIED फ़ॉर्मैट की जानकारी नहीं है.
PHOTO मीडिया आइटम एक फ़ोटो है. इस वर्शन में, सिर्फ़ फ़ोटो का इस्तेमाल किया जा सकता है.
VIDEO मीडिया आइटम एक वीडियो है.

LocationAssociation

मीडिया आइटम उसकी जगह से कैसे जुड़ा है.

JSON के काेड में दिखाना
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
फ़ील्ड
यूनियन फ़ील्ड location_attachment_type. लोकेशन मीडिया के पास या तो कैटगरी या कीमत की सूची के उस आइटम का आईडी होना चाहिए जिससे वे जुड़े हुए हैं. गैर-स्थान मीडिया (उदाहरण के लिए, स्थानीय पोस्ट की फ़ोटो) में कोई भी नहीं होना चाहिए. location_attachment_type इनमें से सिर्फ़ एक हो सकता है:
category

enum (Category)

वह श्रेणी जिससे यह स्थान फ़ोटो संबंधित है.

priceListItemId

string

कीमत की सूची में शामिल उस आइटम का आईडी जिससे जगह की फ़ोटो जुड़ी है.

कैटगरी

मीडिया आइटम की कैटगरी के लिए Enum.

Enums
CATEGORY_UNSPECIFIED कैटगरी नहीं बताई गई है.
COVER कवर फ़ोटो. एक स्थान में सिर्फ़ एक कवर फ़ोटो है.
PROFILE प्रोफ़ाइल फ़ोटो. एक स्थान की सिर्फ़ एक प्रोफ़ाइल फ़ोटो है.
EXTERIOR एक्सटीरियर मीडिया.
INTERIOR अंदर के मीडिया.
PRODUCT प्रॉडक्ट मीडिया.
AT_WORK 'काम पर' मीडिया.
FOOD_AND_DRINK खाने-पीने से जुड़ा मीडिया.
MENU मेन्यू मीडिया.
COMMON_AREA कॉमन एरिया का मीडिया.
ROOMS रूम मीडिया.
TEAMS टीम मीडिया.
ADDITIONAL अन्य, अवर्गीकृत मीडिया.

डाइमेंशन

मीडिया आइटम के डाइमेंशन.

JSON के काेड में दिखाना
{
  "widthPixels": integer,
  "heightPixels": integer
}
फ़ील्ड
widthPixels

integer

मीडिया आइटम की चौड़ाई, पिक्सल में.

heightPixels

integer

मीडिया आइटम की ऊंचाई, पिक्सल में.

MediaInsights

मीडिया आइटम के लिए अहम जानकारी और आंकड़े.

JSON के काेड में दिखाना
{
  "viewCount": string
}
फ़ील्ड
viewCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. मीडिया आइटम को देखे जाने की संख्या.

एट्रिब्यूशन

ग्राहक मीडिया आइटम के एट्रिब्यूशन की जानकारी, जैसे कि योगदान देने वाले का नाम और प्रोफ़ाइल फ़ोटो.

JSON के काेड में दिखाना
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
फ़ील्ड
profileName

string

मीडिया आइटम को एट्रिब्यूट करने के लिए उपयोगकर्ता नाम.

profilePhotoUrl

string

एट्रिब्यूट किए गए उपयोगकर्ता की प्रोफ़ाइल फ़ोटो के थंबनेल का यूआरएल.

takedownUrl

string

वीडियो हटाने के पेज का यूआरएल, जहां मीडिया आइटम के आपत्तिजनक होने पर उसकी शिकायत की जा सकती है.

profileUrl

string

एट्रिब्यूट किए गए उपयोगकर्ता के Google Maps प्रोफ़ाइल पेज का यूआरएल.

तरीके

create

स्थान के लिए नया मीडिया आइटम बनाता है.

delete

बताए गए मीडिया आइटम को मिटाता है.

get

अनुरोध किए गए मीडिया आइटम के लिए मेटाडेटा दिखाता है.

list

किसी जगह से जुड़े मीडिया आइटम की सूची दिखाता है.

patch

बताए गए मीडिया आइटम का मेटाडेटा अपडेट करता है.

startUpload

मीडिया आइटम अपलोड करने के लिए, MediaItemDataRef जनरेट करता है.