REST Resource: accounts.locations.media

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 (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.
}
Trường
name

string

Tên tài nguyên của mục nội dung nghe nhìn này. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Định dạng của mục nội dung nghe nhìn này. Phải được đặt khi mục nội dung nghe nhìn được tạo và chỉ có thể đọc trong tất cả các yêu cầu khác. Không thể cập nhật.
locationAssociation

object (LocationAssociation)

Bắt buộc khi gọi CreatePhoto. Mô tả cách mục nội dung nghe nhìn này được kết nối với vị trí của nó. Phải là một danh mục (ví dụ: EXTERIOR) hoặc mã nhận dạng của một mặt hàng trong bảng giá.

Đây là thông tin bắt buộc khi thêm nội dung nghe nhìn mới vào một vị trí có media.create. Đối với các loại nội dung nghe nhìn khác (ví dụ: ảnh trên bài đăng tại địa phương), thông tin này sẽ không xuất hiện.
googleUrl

string

Chỉ có đầu ra. URL do Google lưu trữ cho mục nội dung nghe nhìn này. URL này không cố định vì có thể thay đổi theo thời gian. Đối với video, đây sẽ là hình ảnh xem trước có biểu tượng phát phủ lên.
thumbnailUrl

string

Chỉ có đầu ra. Nếu được cung cấp, đây là URL của hình thu nhỏ cho mục nội dung nghe nhìn này.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo của mục nội dung nghe nhìn này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Chỉ có đầu ra. Kích thước (chiều rộng và chiều cao) tính bằng pixel.
insights

object (MediaInsights)

Chỉ có đầu ra. Số liệu thống kê cho mục nội dung nghe nhìn này.
attribution

object (Attribution)

Chỉ có đầu ra. Thông tin phân bổ cho các mục nội dung đa phương tiện của khách hàng. Bạn phải hiển thị thông tin phân bổ này cho người dùng và không được xoá hoặc sửa đổi thông tin phân bổ.
description

string

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 có thể đặt nội dung mô tả khi tạo một mục nội dung nghe nhìn mới không phải là ảnh bìa.

Trường nhóm data. Nguồn dữ liệu của mục nội dung nghe nhìn. Khi tạo một mục nội dung nghe nhìn mới, bạn phải cung cấp URL hoặc tham chiếu dữ liệu.

Ngoại trừ danh mục PROFILE và COVER, tất cả ảnh phải có kích thước tối thiểu là 250px ở cạnh ngắn, với kích thước tệp tối thiểu là 10240 byte.

Tất cả ảnh được tải lên đều phải tuân thủ nguyên tắc về ảnh của Trang doanh nghiệp. data chỉ có thể là một trong những trạng thái sau:
sourceUrl

string

URL có thể truy cập công khai để truy xuất mục nội dung nghe nhìn.

Khi tạo một trong các đối tượng này, bạn phải đặt dataRef để chỉ định nguồn của mục nội dung nghe nhìn.

Nếu sourceUrl được dùng khi tạo một mục nội dung nghe nhìn, thì mục đó sẽ được điền sẵn URL nguồn khi mục nội dung nghe nhìn được truy xuất.

Bạn không thể cập nhật trường này.
dataRef

object (MediaItemDataRef)

Chỉ có đầu vào. Tham chiếu đến dữ liệu nhị phân của mục nội dung nghe nhìn do phương thức media.startUpload thu được.

Khi tạo một mục nội dung nghe nhìn, hãy

sourceUrl

hoặc

dataRef

phải được đặt.

MediaItemDataRef

Tham chiếu đến dữ liệu nhị phân của ảnh MediaItem được tải lên thông qua API Google Doanh nghiệp của tôi.

Tạo một tham chiếu dữ liệu bằng cách sử dụ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
}
Trường
resourceName

string

Mã nhận dạng duy nhất của dữ liệu nhị phân của mục nội dung nghe nhì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 nghe nhìn mới từ các byte đó bằng media.create.

Ví dụ về việc tải byte lên: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Đối với các lệnh gọi media.create, hãy đặt lệnh gọi này làm MediaItem dataRef.

MediaFormat

Enum cho định dạng nội dung nghe nhìn.

Enum
MEDIA_FORMAT_UNSPECIFIED Không chỉ định định dạng.
PHOTO Mục nội dung nghe nhìn là ảnh. Trong phiên bản này, chỉ có ảnh được hỗ trợ.
VIDEO Mục nội dung nghe nhìn là một video.

LocationAssociation

Cách mục nội dung nghe nhìn được liên kết với vị trí của mục đó.

Biểu diễn dưới dạng 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.
}
Trường
Trường nhóm location_attachment_type. Nội dung nghe nhìn về địa điểm phải có danh mục hoặc mã nhận dạng của một mặt hàng trong bảng giá mà nội dung đó được liên kết. Nội dung nghe nhìn không có thông tin vị trí (ví dụ: ảnh trong bài đăng tại đị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:
category

enum (Category)

Danh mục của bức ảnh về địa điểm này.
priceListItemId

string

Mã nhận dạng của một mục trong bảng giá mà bức ảnh này về vị trí được liên kết.

Danh mục

Enum cho danh mục mục nội dung nghe nhìn.

Enum
CATEGORY_UNSPECIFIED Danh mục chưa xác định.
COVER Ảnh bìa. Mỗi vị trí chỉ có một ảnh bìa.
PROFILE Ảnh hồ sơ. Một vị trí chỉ có một ảnh hồ sơ.
EXTERIOR Nội dung nghe nhìn bên ngoài.
INTERIOR Nội dung nghe nhìn về nội thất.
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ề đồ ăn và thức uống.
MENU Nội dung nghe nhìn trong trình đơn.
COMMON_AREA Nội dung nghe nhìn tại khu vực chung.
ROOMS Nội dung nghe nhìn trong phòng.
TEAMS Nội dung nghe nhìn của nhóm.
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
}
Trường
widthPixels

integer

Chiều rộng của mục nội dung nghe nhìn, tính bằng pixel.
heightPixels

integer

Chiều cao của mục nội dung nghe nhì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
}
Trường
viewCount

string (int64 format)

Chỉ có đầu ra. Số lần người dùng đã xem mục nội dung nghe nhìn.

Phân bổ

Thông tin ghi nhận quyền tác giả 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
}
Trường
profileName

string

Tên người dùng để gán mục nội dung nghe nhìn.
profilePhotoUrl

string

URL của hình thu nhỏ ảnh hồ sơ của người dùng được phân bổ.
takedownUrl

string

URL của trang gỡ bỏ, nơi bạn có thể báo cáo mục nội dung nghe nhìn nếu mục đó không phù hợp.
profileUrl

string

URL của trang hồ sơ trên Google Maps của người dùng được phân bổ.

Phương thức

create

 Tạo một mục nội dung nghe nhìn mới cho vị trí.

delete

 Xoá mục nội dung nghe nhìn đã chỉ định.

get

 Trả về siêu dữ liệu cho mục nội dung nghe nhìn được yêu cầu.

list

 Trả về danh sách các mục nội dung nghe nhìn được liên kết với một vị trí.

patch

 Cập nhật siêu dữ liệu của mục nội dung nghe nhìn được chỉ định.

startUpload

 Tạo một MediaItemDataRef để tải mục nội dung nghe nhìn lên.