REST Resource: accounts.locations.media.customers

منبع: 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

فقط خروجی URL میزبانی شده توسط Google برای این آیتم رسانه. این URL ثابت نیست زیرا ممکن است در طول زمان تغییر کند. برای ویدیو، این یک تصویر پیش‌نمایش با نماد پخش است.

thumbnailUrl

string

فقط خروجی در جایی که ارائه شده است، نشانی اینترنتی یک تصویر کوچک برای این مورد رسانه.

createTime

string ( Timestamp format)

فقط خروجی زمان ایجاد این آیتم رسانه ای

مهر زمانی در قالب RFC3339 UTC "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 میدان اتحادیه منبع داده آیتم رسانه. هنگام ایجاد یک آیتم رسانه جدید، باید URL یا مرجع داده ارائه شود.

به استثنای طبقه بندی PROFILE و COVER ، همه عکس ها باید حداقل 250 پیکسل در لبه کوتاه اندازه داشته باشند و اندازه فایل حداقل 10240 بایت باشد.

همه عکس‌های آپلود شده باید از دستورالعمل‌های نمایه کسب‌وکار برای عکس‌ها پیروی کنند. data فقط می توانند یکی از موارد زیر باشند:

sourceUrl

string

یک URL در دسترس عموم که می‌توان آیتم رسانه را از آن بازیابی کرد.

هنگام ایجاد یکی از این یا dataRef باید برای تعیین منبع مورد رسانه تنظیم شود.

اگر sourceUrl هنگام ایجاد یک آیتم رسانه استفاده شده باشد، هنگام بازیابی آیتم رسانه، با آن URL منبع پر می شود.

این فیلد به روز نمی شود.

dataRef

object ( MediaItemDataRef )

فقط ورودی ارجاع به داده های باینری آیتم رسانه که با روش media.startUpload به دست آمده است.

هنگام ایجاد یک آیتم رسانه ای، یا

sourceUrl

یا

dataRef

باید تنظیم شود.

روش ها

get

 فراداده مورد درخواست رسانه مشتری را برمی گرداند.

list

 فهرستی از آیتم‌های رسانه مرتبط با مکانی را که توسط مشتریان ارائه شده است، برمی‌گرداند.