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 นี้ไม่ใช่ 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 แหล่งที่มานั้นด้วย 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 ให้ตั้งค่าเป็น dataRef ของ MediaItem

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 สื่อสถานที่ตั้งต้องมีหมวดหมู่หรือรหัสของรายการราคาที่เชื่อมโยงกับสื่อเหล่านั้น สื่อที่ไม่ใช่ตำแหน่ง (เช่น รูปภาพโพสต์ในท้องถิ่น) ต้องไม่มีทั้ง 2 อย่าง location_attachment_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
category

enum (Category)

หมวดหมู่ที่มีรูปภาพของสถานที่นี้
priceListItemId

string

รหัสของรายการราคาที่เชื่อมโยงกับรูปภาพของสถานที่นี้

หมวดหมู่

Enum สำหรับหมวดหมู่รายการสื่อ

Enum
CATEGORY_UNSPECIFIED หมวดหมู่ที่ไม่ได้ระบุ
COVER รูปภาพปก สถานที่หนึ่งมีรูปภาพปกเพียงรูปเดียว
PROFILE รูปโปรไฟล์ สถานที่หนึ่งมีรูปโปรไฟล์เพียงรูปเดียว
EXTERIOR สื่อภายนอก
INTERIOR สื่อภายใน
PRODUCT สื่อของผลิตภัณฑ์
AT_WORK "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 สำหรับการอัปโหลดรายการสื่อ