Tài nguyên: MediaItem
Một mục nội dung nghe nhìn.
Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
Các trường | ||
---|---|---|
name |
Tên tài nguyên cho mục nội dung đa phương tiện này. |
|
mediaFormat |
Định dạng của mục nội dung nghe nhìn này. Bạn phải đặt mục này khi tạo mục nội dung đa phương tiện và đặt ở chế độ chỉ đọc đối với mọi yêu cầu khác. Không thể cập nhật. |
|
locationAssociation |
Bắt buộc khi gọi Đây là yêu cầu bắt buộc khi thêm nội dung nghe nhìn mới vào một vị trí bằng |
|
googleUrl |
Chỉ có đầu ra. URL do Google lưu trữ cho mục nội dung đa phương tiện này. URL này không tĩnh vì có thể thay đổi theo thời gian. Đối với video, đây sẽ là hình ảnh xem trước có lớp phủ biểu tượng phát. |
|
thumbnailUrl |
Chỉ có đầu ra. Nếu được cung cấp, URL của hình thu nhỏ cho mục nội dung đa phương tiện này. |
|
createTime |
Chỉ có đầu ra. Thời gian tạo mục nội dung đa phương tiện này. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
|
dimensions |
Chỉ có đầu ra. Kích thước (chiều rộng và chiều cao) tính bằng pixel. |
|
insights |
Chỉ có đầu ra. Số liệu thống kê cho mục nội dung nghe nhìn này. |
|
attribution |
Chỉ có đầu ra. Thông tin phân bổ cho các mục nội dung nghe nhìn của khách hàng. Bạn phải hiển thị thuộc tính này như đã cung cấp cho người dùng của mình và không được xoá hoặc thay đổi thuộc tính. |
|
description |
Nội dung mô tả cho mục nội dung nghe nhìn này. Bạn không thể sửa đổi nội dung mô tả thông qua API Google Doanh nghiệp của tôi, nhưng bạn có thể đặt nội dung mô tả khi tạo mục nội dung nghe nhìn mới không phải là ảnh bìa. |
|
Trường nhóm Ngoại trừ danh mục Tất cả ảnh được tải lên phải tuân thủ nguyên tắc về Trang doanh nghiệp về ảnh. |
||
sourceUrl |
URL có thể truy cập công khai để truy xuất mục nội dung đa phương tiện. Khi tạo một trong các mục này hoặc dataRef phải được đặt để chỉ định nguồn của mục nội dung đa phương tiện. Nếu bạn sử dụng Không thể cập nhật trường này. |
|
dataRef |
Chỉ nhập. Tham chiếu đến dữ liệu nhị phân của mục nội dung đa phương tiện do phương thức Khi tạo mục nội dung nghe nhìn,
hoặc
. |
MediaItemDataRef
Tham chiếu đến dữ liệu tệp nhị phân về ảnh của MediaItem
được tải lên thông qua API Google Doanh nghiệp của tôi.
Tạo tham chiếu dữ liệu bằng media.startUpload
và sử dụng tham chiếu này khi tải byte lên [media.upload] rồi gọi media.create
.
Biểu diễn dưới dạng JSON | |
---|---|
{ "resourceName": string } |
Các trường | |
---|---|
resourceName |
Mã nhận dạng duy nhất cho dữ liệu nhị phân của mục nội dung đa phương tiện này. Dùng để tải dữ liệu ảnh lên bằng [media.upload] và khi tạo một mục nội dung đa phương tiện mới từ các byte đó bằng Ví dụ về cách tải byte lên: Đối với các lệnh gọi |
MediaFormat
Enum cho định dạng nội dung đa phương tiện.
Enum | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
Chưa xác định định dạng. |
PHOTO |
Mục nội dung đa phương tiện là ảnh. Trong phiên bản này, chỉ có ảnh mới được hỗ trợ. |
VIDEO |
Mục nội dung đa phương tiện là một video. |
LocationAssociation
Cách mục nội dung nghe nhìn liên kết với vị trí của mục đó.
Biểu diễn dưới dạng JSON | |
---|---|
{ // Union field |
Các trường | ||
---|---|---|
Trường nhóm location_attachment_type . Phương tiện vị trí phải có danh mục hoặc mã của mục trong danh sách giá liên kết với phương tiện đó. Nội dung nghe nhìn không phải vị trí (ví dụ: ảnh bài đăng địa phương) không được có cả hai. location_attachment_type chỉ có thể là một trong những trạng thái sau đây: |
||
category |
Danh mục chứa ảnh vị trí này. |
|
priceListItemId |
Mã của mục trong danh sách giá liên kết với ảnh vị trí này. |
Danh mục
Enum cho danh mục mục nội dung đa phương tiện.
Enum | |
---|---|
CATEGORY_UNSPECIFIED |
Danh mục chưa được chỉ định. |
COVER |
Ảnh bìa. Một vị trí chỉ có một ảnh bìa. |
PROFILE |
Ảnh hồ sơ. Một vị trí chỉ có một ảnh hồ sơ. |
LOGO |
Ảnh biểu trưng. |
EXTERIOR |
Nội dung nghe nhìn bên ngoài. |
INTERIOR |
Nội dung nghe nhìn trong nhà. |
PRODUCT |
Nội dung nghe nhìn về sản phẩm. |
AT_WORK |
Nội dung nghe nhìn "Tại nơi làm việc". |
FOOD_AND_DRINK |
Nội dung nghe nhìn về thực phẩm và đồ uống. |
MENU |
Nội dung nghe nhìn trong trình đơn. |
COMMON_AREA |
Phương tiện truyền thông khu vực chung. |
ROOMS |
Nội dung nghe nhìn trong Room. |
TEAMS |
Nội dung nghe nhìn trên Teams. |
ADDITIONAL |
Nội dung nghe nhìn bổ sung, chưa được phân loại. |
Kích thước
Kích thước của mục nội dung nghe nhìn.
Biểu diễn dưới dạng JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
Các trường | |
---|---|
widthPixels |
Chiều rộng của mục nội dung đa phương tiện, tính bằng pixel. |
heightPixels |
Chiều cao của mục nội dung đa phương tiện, tính bằng pixel. |
MediaInsights
Thông tin chi tiết và số liệu thống kê cho mục nội dung nghe nhìn.
Biểu diễn dưới dạng JSON | |
---|---|
{ "viewCount": string } |
Các trường | |
---|---|
viewCount |
Chỉ có đầu ra. Số lần người dùng đã xem mục nội dung đa phương tiện này. |
Phân bổ
Thông tin ghi công cho các mục nội dung nghe nhìn của khách hàng, chẳng hạn như tên và ảnh hồ sơ của người đóng góp.
Biểu diễn dưới dạng JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
Các trường | |
---|---|
profileName |
Tên người dùng để phân bổ mục nội dung đa phương tiện. |
profilePhotoUrl |
URL của hình thu nhỏ ảnh hồ sơ của người dùng được chỉ định. |
takedownUrl |
URL của trang yêu cầu gỡ bỏ, nơi có thể báo cáo nội dung đa phương tiện nếu nội dung đó không phù hợp. |
profileUrl |
URL trang hồ sơ trên Google Maps của người dùng được phân bổ. |
Phương thức |
|
---|---|
|
Tạo mục nội dung nghe nhìn mới cho vị trí đó. |
|
Xoá mục nội dung đa phương tiện đã chỉ định. |
|
Trả về siêu dữ liệu cho mục nội dung đa phương tiện được yêu cầu. |
|
Trả về danh sách các mục nội dung đa phương tiện được liên kết với một vị trí. |
|
Cập nhật siêu dữ liệu của mục nội dung đa phương tiện đã chỉ định. |
|
Tạo MediaItemDataRef để tải mục nội dung nghe nhìn lên. |