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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक होते हैं. उदाहरण: "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 'At-work' मीडिया.
FOOD_AND_DRINK खाने-पीने से जुड़ा मीडिया.
MENU मेन्यू मीडिया.
COMMON_AREA कॉमन एरिया मीडिया.
ROOMS मीटिंग रूम का मीडिया.
TEAMS 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 जनरेट करती है.