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

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

thumbnailUrl

string

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

createTime

string ( Timestamp format)

فقط خروجی. زمان ایجاد این مورد رسانه‌ای.

یک مهر زمانی در قالب RFC3339 UTC "زولو"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

dimensions

object ( Dimensions )

فقط خروجی. ابعاد (عرض و ارتفاع) بر حسب پیکسل.

insights

object ( MediaInsights )

فقط خروجی. آمار این مورد رسانه‌ای.

attribution

object ( Attribution )

فقط خروجی. اطلاعات مربوط به انتساب برای اقلام رسانه‌ای مشتری. شما باید این انتساب را همانطور که به کاربرانتان ارائه شده است نمایش دهید و نباید انتساب را حذف یا تغییر دهید.

description

string

توضیحات این مورد رسانه‌ای. توضیحات را نمی‌توان از طریق API گوگل برای کسب‌وکار من تغییر داد، اما می‌توان هنگام ایجاد یک مورد رسانه‌ای جدید که عکس روی جلد نیست، آنها را تنظیم کرد.

data فیلد Union. منبع داده‌ی آیتم رسانه. هنگام ایجاد یک آیتم رسانه‌ی جدید، باید یک URL یا مرجع داده ارائه شود.

به استثنای بخش‌های PROFILE و COVER ، تمام عکس‌ها باید حداقل ۲۵۰ پیکسل در لبه کوتاه و حجم فایل حداقل ۱۰۲۴۰ بایت داشته باشند.

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

sourceUrl

string

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

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

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

این فیلد قابل به‌روزرسانی نیست.

dataRef

object ( MediaItemDataRef )

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

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

sourceUrl

یا

dataRef

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

MediaItemDataRef

ارجاع به داده‌های دودویی عکس یک MediaItem که از طریق API گوگل مای بیزینس آپلود شده است.

با استفاده از 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 تنظیم کنید.

مدیافرمت

Enum برای قالب رسانه.

انوم‌ها
MEDIA_FORMAT_UNSPECIFIED قالب مشخص نشده.
PHOTO مورد رسانه‌ای یک عکس است. در این نسخه، فقط عکس‌ها پشتیبانی می‌شوند.
VIDEO آیتم رسانه‌ای یک ویدیو است.

انجمن موقعیت مکانی

چگونه آیتم رسانه‌ای با مکان خود مرتبط است.

نمایش 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 برای دسته بندی آیتم های رسانه ای.

انوم‌ها
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

ارتفاع آیتم رسانه‌ای، بر حسب پیکسل.

مدیا اینسایتس

بینش‌ها و آمار مربوط به آیتم رسانه‌ای.

نمایش JSON 
{
  "viewCount": string
}
فیلدها
viewCount

string ( int64 format)

فقط خروجی. تعداد دفعاتی که آیتم رسانه‌ای مشاهده شده است.

انتساب

اطلاعات مربوط به انتساب موارد رسانه‌ای مشتری، مانند نام و تصویر نمایه مشارکت‌کننده.

نمایش JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
فیلدها
profileName

string

نام کاربری که آیتم رسانه‌ای به آن نسبت داده می‌شود.

profilePhotoUrl

string

نشانی اینترنتی (URL) تصویر کوچک عکس نمایه کاربر منتسب.

takedownUrl

string

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

profileUrl

string

نشانی اینترنتی صفحه نمایه نقشه‌های گوگل کاربر منتسب.

روش‌ها

create

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

delete

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

get

 متادیتای مربوط به آیتم رسانه‌ای درخواست شده را برمی‌گرداند.

list

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

patch

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

startUpload

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