REST Resource: accounts.locations.media

संसाधन: MediaItem

सिंगल मीडिया आइटम.

जेएसओएन के काेड में दिखाना 
{
  "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)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "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 को कॉल करते समय, इस रेफ़रंस का इस्तेमाल करें.

जेएसओएन के काेड में दिखाना 
{
  "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

मीडिया आइटम अपनी जगह से कैसे जुड़ा होता है.

जेएसओएन के काेड में दिखाना 
{

  // 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 Teams मीडिया.
ADDITIONAL अतिरिक्त, अवर्ग मीडिया.

डाइमेंशन

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

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

integer

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

integer

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

MediaInsights

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

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

string (int64 format)

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

एट्रिब्यूशन

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

जेएसओएन के काेड में दिखाना 
{
  "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 जनरेट करता है.