ทรัพยากร: MediaItem
สื่อรายการเดียว
การแสดง JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
ช่อง | ||
---|---|---|
name |
ชื่อทรัพยากรสำหรับรายการสื่อนี้ |
|
mediaFormat |
รูปแบบของรายการสื่อนี้ ต้องตั้งค่าเมื่อมีการสร้างรายการสื่อและเป็นแบบอ่านอย่างเดียวในคำขออื่นๆ ทั้งหมด อัปเดตไม่ได้ |
|
locationAssociation |
ต้องระบุเมื่อโทรหา ซึ่งจำเป็นเมื่อเพิ่มสื่อใหม่ไปยังตำแหน่งด้วย |
|
googleUrl |
เอาต์พุตเท่านั้น URL ที่โฮสต์โดย Google สำหรับรายการสื่อนี้ URL นี้ไม่คงที่เนื่องจากอาจเปลี่ยนแปลงได้ในอนาคต สำหรับวิดีโอ รูปภาพนี้จะเป็นตัวอย่างรูปภาพที่มีไอคอนเล่นวางซ้อนอยู่ |
|
thumbnailUrl |
เอาต์พุตเท่านั้น ในกรณีที่ระบุ URL ของรูปภาพขนาดย่อสำหรับรายการสื่อนี้ |
|
createTime |
เอาต์พุตเท่านั้น เวลาที่สร้างรายการสื่อนี้ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
|
dimensions |
เอาต์พุตเท่านั้น ขนาด (ความกว้างและความสูง) ในหน่วยพิกเซล |
|
insights |
เอาต์พุตเท่านั้น สถิติสำหรับรายการสื่อนี้ |
|
attribution |
เอาต์พุตเท่านั้น ข้อมูลการระบุแหล่งที่มาของรายการสื่อของลูกค้า คุณต้องแสดงการระบุแหล่งที่มานี้ตามที่ให้ไว้แก่ผู้ใช้ และต้องไม่ลบหรือแก้ไขการระบุแหล่งที่มา |
|
description |
คำอธิบายสำหรับรายการสื่อนี้ คุณจะแก้ไขคำอธิบายผ่าน Google My Business API ไม่ได้ แต่จะตั้งค่าได้เมื่อสร้างรายการสื่อใหม่ที่ไม่ใช่รูปภาพปก |
|
ฟิลด์การรวม รูปภาพทุกรูปต้องมีขนาดอย่างน้อย 250 พิกเซลที่ขอบด้านสั้น และมีขนาดไฟล์อย่างน้อย 10240 ไบต์ ยกเว้นหมวดหมู่ รูปภาพที่อัปโหลดทั้งหมดต้องเป็นไปตามหลักเกณฑ์ด้านรูปภาพของ Business Profile |
||
sourceUrl |
URL ที่เข้าถึงได้แบบสาธารณะซึ่งจะดึงข้อมูลรายการสื่อได้ เมื่อสร้างอย่างใดอย่างหนึ่งนี้หรือต้องระบุ dataRef เพื่อระบุแหล่งที่มาของรายการสื่อ หากใช้ อัปเดตช่องนี้ไม่ได้ |
|
dataRef |
อินพุตเท่านั้น การอ้างอิงข้อมูลไบนารีของรายการสื่อตามที่ได้รับจากเมธอด เมื่อสร้างรายการสื่อ ทำอย่างใดอย่างหนึ่งต่อไปนี้
หรือ
ต้องตั้งค่า |
MediaItemDataRef
การอ้างอิงข้อมูลไบนารีรูปภาพของ MediaItem
ที่อัปโหลดผ่าน Google My Business API
สร้างการอ้างอิงข้อมูลโดยใช้ media.startUpload
และใช้ข้อมูลอ้างอิงนี้เมื่ออัปโหลดไบต์ไปยัง [media.upload] แล้วเรียกใช้ media.create
ในภายหลัง
การแสดง JSON | |
---|---|
{ "resourceName": string } |
ช่อง | |
---|---|
resourceName |
รหัสที่ไม่ซ้ำกันสำหรับข้อมูลไบนารีของรายการสื่อนี้ ใช้เพื่ออัปโหลดข้อมูลรูปภาพด้วย [media.upload] และเมื่อสร้างรายการสื่อใหม่จากไบต์เหล่านั้นด้วย ตัวอย่างไบต์ที่อัปโหลด: สำหรับการโทร |
MediaFormat
enum สำหรับรูปแบบสื่อ
Enum | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
ไม่ได้ระบุรูปแบบ |
PHOTO |
รายการสื่อคือรูปภาพ เวอร์ชันนี้รองรับเฉพาะรูปภาพเท่านั้น |
VIDEO |
รายการสื่อคือวิดีโอ |
LocationAssociation
วิธีเชื่อมโยงรายการสื่อกับตำแหน่งของรายการ
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม location_attachment_type สื่อสถานที่ตั้งต้องมีหมวดหมู่หรือรหัสของรายการราคาที่เกี่ยวข้องกับรายการดังกล่าว สื่อที่ไม่มีสถานที่ (เช่น รูปภาพโพสต์ในเครื่อง) ต้องไม่มีทั้งสองอย่าง location_attachment_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
category |
หมวดหมู่ที่มีรูปภาพสถานที่นี้ |
|
priceListItemId |
รหัสของรายการราคาที่เชื่อมโยงกับรูปภาพสถานที่นี้ |
หมวดหมู่
Enum สำหรับหมวดหมู่รายการสื่อ
Enum | |
---|---|
CATEGORY_UNSPECIFIED |
หมวดหมู่ที่ไม่ได้ระบุ |
COVER |
รูปภาพปก สถานที่มีรูปภาพปกเพียงรูปเดียว |
PROFILE |
รูปโปรไฟล์ สถานที่มีรูปโปรไฟล์เพียงรูปเดียว |
LOGO |
รูปภาพโลโก้ |
EXTERIOR |
สื่อภายนอก |
INTERIOR |
สื่อภายใน |
PRODUCT |
สื่อของผลิตภัณฑ์ |
AT_WORK |
สื่อ "ที่ทำงาน" |
FOOD_AND_DRINK |
สื่ออาหารและเครื่องดื่ม |
MENU |
สื่อเมนู |
COMMON_AREA |
สื่อในพื้นที่ส่วนกลาง |
ROOMS |
สื่อของห้อง |
TEAMS |
สื่อของทีม |
ADDITIONAL |
สื่อเพิ่มเติมที่ไม่จัดอยู่ในหมวดหมู่ใดๆ |
ขนาด
ขนาดของรายการสื่อ
การแสดง JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
ช่อง | |
---|---|
widthPixels |
ความกว้างของรายการสื่อ หน่วยเป็นพิกเซล |
heightPixels |
ความสูงของรายการสื่อ หน่วยเป็นพิกเซล |
MediaInsights
ข้อมูลเชิงลึกและสถิติสําหรับรายการสื่อ
การแสดง JSON | |
---|---|
{ "viewCount": string } |
ช่อง | |
---|---|
viewCount |
เอาต์พุตเท่านั้น จำนวนครั้งที่มีการดูรายการสื่อ |
การระบุแหล่งที่มา
ข้อมูลการระบุแหล่งที่มาของรายการสื่อของลูกค้า เช่น ชื่อและรูปโปรไฟล์ของผู้มีส่วนร่วม
การแสดง JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
ช่อง | |
---|---|
profileName |
ชื่อผู้ใช้ที่จะระบุแหล่งที่มาของรายการสื่อ |
profilePhotoUrl |
URL ของภาพขนาดย่อของรูปโปรไฟล์ของผู้ใช้ที่มีการระบุที่มา |
takedownUrl |
URL ของหน้าการลบออกซึ่งสามารถรายงานรายการสื่อได้หากไม่เหมาะสม |
profileUrl |
URL หน้าโปรไฟล์ Google Maps ของผู้ใช้ที่มีการระบุแหล่งที่มา |
วิธีการ |
|
---|---|
|
สร้างรายการสื่อใหม่สำหรับสถานที่ดังกล่าว |
|
ลบรายการสื่อที่ระบุ |
|
แสดงข้อมูลเมตาสำหรับรายการสื่อที่ขอ |
|
แสดงรายการสื่อที่เกี่ยวข้องกับตำแหน่ง |
|
อัปเดตข้อมูลเมตาของรายการสื่อที่ระบุ |
|
สร้าง MediaItemDataRef สำหรับการอัปโหลดรายการสื่อ |