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

فقط خروجی 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

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

MediaItemDataRef

ارجاع به داده های باینری عکس یک MediaItem آپلود شده از طریق Google My Business API.

با استفاده از media.startUpload یک ref داده ایجاد کنید و هنگام آپلود بایت در [media.upload] و متعاقبا فراخوانی media.create از این ref استفاده کنید.

نمایندگی 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

شناسه کالای فهرست قیمت که این عکس موقعیت مکانی با آن مرتبط است.

دسته بندی

فهرست برای دسته بندی آیتم های رسانه ای.

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

URL صفحه نمایه Google Maps کاربر نسبت داده شده.

روش ها

create

 یک آیتم رسانه جدید برای مکان ایجاد می کند.

delete

 آیتم رسانه ای مشخص شده را حذف می کند.

get

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

list

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

patch

 فراداده مورد رسانه مشخص شده را به روز می کند.

startUpload

 یک MediaItemDataRef برای آپلود آیتم رسانه ایجاد می کند.