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 ไม่ได้ แต่จะตั้งค่าได้เมื่อสร้างรายการสื่อใหม่ที่ไม่ใช่รูปภาพปก

ฟิลด์ Union data แหล่งข้อมูลของรายการสื่อ เมื่อสร้างรายการสื่อใหม่ คุณต้องระบุ URL หรือการอ้างอิงข้อมูล

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

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