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.
}
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. Phải được đặt khi tạo mục nội dung nghe nhìn và chỉ có thể đọc trên tất cả các yêu cầu khác. Không cập nhật được.

locationAssociation

object (LocationAssociation)

Bắt buộc khi gọi CreatePhoto. Mô tả cách kết nối mục nội dung nghe nhìn này với vị trí của mục đó. Phải là một danh mục (ví dụ: NGOẠI THẤT) hoặc mã nhận dạng của một mặt hàng trong danh sách 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í bằng media.create. Đối với các loại nội dung nghe nhìn khác, ví dụ như ảnh trên bài đăng tại địa phương, thuộc tính 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 phải là URL 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ó biểu tượng phát được phủ lên.

thumbnailUrl

string

Chỉ có đầu ra. URL của hình thu nhỏ cho mục nội dung đa phương tiện này (nếu được cung cấp).

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""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ị thông tin phân bổ này như đã cung cấp cho người dùng và không được xoá hoặc thay đổi thông tin phân bổ đó.

description

string

Nội dung mô tả cho mục nội dung đa phương tiệ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 kết hợp 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 PROFILECOVER, tất cả ảnh đều 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 nhất là 10240 byte.

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

sourceUrl

string

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

Khi tạo một trong số các mục này hoặc dataRef, bạn phải đặt dataRef để 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ột mục nội dung đa phương tiện, thì mục đó sẽ được điền sẵn 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. Thông tin tham chiếu đến dữ liệu nhị phân của mục nội dung đa phương tiện lấy được bằng phương thức media.startUpload.

Khi tạo một mục nội dung nghe nhìn, bạn có thể

sourceUrl

hoặc

dataRef

phải được đặt.

Phương thức

get

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

list

Trả về danh sách các mục nội dung nghe nhìn liên kết với một vị trí do khách hàng đóng góp.