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

เอาต์พุตเท่านั้น ในกรณีที่ระบุ URL ของรูปภาพขนาดย่อสำหรับรายการสื่อนี้
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างรายการสื่อนี้

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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 หรือข้อมูลอ้างอิง

รูปภาพทุกรูปต้องมีขนาดอย่างน้อย 250 พิกเซลที่ขอบด้านสั้น และมีขนาดไฟล์อย่างน้อย 10240 ไบต์ ยกเว้นหมวดหมู่ PROFILE และ COVER

รูปภาพที่อัปโหลดทั้งหมดต้องเป็นไปตามหลักเกณฑ์ด้านรูปภาพของ Business Profile data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sourceUrl

string

URL ที่เข้าถึงได้แบบสาธารณะซึ่งจะดึงข้อมูลรายการสื่อได้

เมื่อสร้างอย่างใดอย่างหนึ่งนี้หรือต้องระบุ dataRef เพื่อระบุแหล่งที่มาของรายการสื่อ

หากใช้ sourceUrl ขณะสร้างรายการสื่อ ระบบจะป้อนข้อมูลด้วย URL แหล่งที่มานั้นเมื่อมีการเรียกข้อมูลรายการสื่อ

อัปเดตช่องนี้ไม่ได้
dataRef

object (MediaItemDataRef)

อินพุตเท่านั้น การอ้างอิงข้อมูลไบนารีของรายการสื่อตามที่ได้รับจากเมธอด media.startUpload

เมื่อสร้างรายการสื่อ ทำอย่างใดอย่างหนึ่งต่อไปนี้

sourceUrl

หรือ

dataRef

ต้องตั้งค่า

MediaItemDataRef

การอ้างอิงข้อมูลไบนารีรูปภาพของ MediaItem ที่อัปโหลดผ่าน Google My Business 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

MediaFormat

enum สำหรับรูปแบบสื่อ

Enum
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 สำหรับหมวดหมู่รายการสื่อ

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

ความสูงของรายการสื่อ หน่วยเป็นพิกเซล

MediaInsights

ข้อมูลเชิงลึกและสถิติสําหรับรายการสื่อ

การแสดง JSON 
{
  "viewCount": string
}
ช่อง
viewCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนครั้งที่มีการดูรายการสื่อ

การระบุแหล่งที่มา

ข้อมูลการระบุแหล่งที่มาของรายการสื่อของลูกค้า เช่น ชื่อและรูปโปรไฟล์ของผู้มีส่วนร่วม

การแสดง JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
ช่อง
profileName

string

ชื่อผู้ใช้ที่จะระบุแหล่งที่มาของรายการสื่อ
profilePhotoUrl

string

URL ของภาพขนาดย่อของรูปโปรไฟล์ของผู้ใช้ที่มีการระบุที่มา
takedownUrl

string

URL ของหน้าการลบออกซึ่งสามารถรายงานรายการสื่อได้หากไม่เหมาะสม
profileUrl

string

URL หน้าโปรไฟล์ Google Maps ของผู้ใช้ที่มีการระบุแหล่งที่มา

วิธีการ

create

 สร้างรายการสื่อใหม่สำหรับสถานที่ดังกล่าว

delete

 ลบรายการสื่อที่ระบุ

get

 แสดงข้อมูลเมตาสำหรับรายการสื่อที่ขอ

list

 แสดงรายการสื่อที่เกี่ยวข้องกับตำแหน่ง

patch

 อัปเดตข้อมูลเมตาของรายการสื่อที่ระบุ

startUpload

 สร้าง MediaItemDataRef สำหรับการอัปโหลดรายการสื่อ