REST Resource: accounts.locations.media.customers

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.
}
Các trường
name

string

Tên tài nguyên cho mục nội dung đa phương tiệ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. 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

object (LocationAssociation)

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

Đâ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 media.create. Đối với các loại nội dung nghe nhìn khác, chẳng hạn như ảnh trên bài đăng tại địa phương, thì loại nội dung 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 đ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

string

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

string (Timestamp format)

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ụ: "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 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

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 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 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 đa phương tiệ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 trên 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 phải tuân thủ nguyên tắc về Trang doanh nghiệp về ảnh. data chỉ có thể là một trong những trạng thái sau đây:
sourceUrl

string

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 sourceUrl khi tạo mục nội dung đa phương tiện, thì mục này sẽ được điền bằng URL nguồn đó khi mục nội dung đa phương tiện được truy xuất.

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

object (MediaItemDataRef)

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 media.startUpload thu được.

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

sourceUrl

hoặc

dataRef

.

Phương thức

get

 Trả về siêu dữ liệu cho mục nội dung nghe nhìn của khách hàng được yêu cầu.

list

 Trả về danh sách các mục phương tiện được liên kết với một vị trí do khách hàng đã đóng góp.