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 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 đa phương tiện này. Bạn phải đặt chế độ này khi tạo mục nội dung đa phương tiện và ở chế độ chỉ đọc đối với 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 mục nội dung đa phương tiện này kết nối với vị trí của mục. Phải là một danh mục (ví dụ: EXTERIOR) hoặc mã nhận dạng 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, 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 đa phương tiện này. URL này không thể thay đổi 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 ở lớp phủ.

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 đa phương tiện này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. 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 đa phương tiệ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 bạn 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 đ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 đa phương tiệ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 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 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 trạng thái sau đây:

sourceUrl

string

URL có thể truy cập công khai nơi có thể truy xuất mục nội dung đa phương tiệ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 này sẽ được điền sẵn URL nguồn đó khi truy xuất mục nội dung đa phương tiện.

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:

sourceUrl

hoặc

dataRef

phải được đặt.

MediaItemDataRef

Tham chiếu đến dữ liệu ảnh nhị phân của 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 media.startUpload rồi 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 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 nghe nhìn mới từ các byte đó bằng media.create.

Ví dụ về cách 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 lệnh gọi media.create, hãy đặt giá trị này thành MediaItem dataRef.

MediaFormat

Enum cho định dạng nội dung nghe nhì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à một ảnh. Trong phiên bản này, chỉ ảnh đượ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 đa phương tiện 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 kết hợp location_attachment_type. Phương tiện vị trí phải có danh mục hoặc mã của mục danh sách giá liên kết với phương tiện đó. Nội dung nghe nhìn không liên quan đến vị trí (ví dụ: ảnh 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 đây:
category

enum (Category)

Danh mục chứa ảnh vị trí này.

priceListItemId

string

Mã của mặt hàng trong danh sách giá có 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 không xác đị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ơ.
EXTERIOR Phương tiện bên ngoài.
INTERIOR Nội dung nghe nhìn nội thất.
PRODUCT Nội dung nghe nhìn của sản phẩm.
AT_WORK "Tại nơi làm việc" nội dung đa phương tiện.
FOOD_AND_DRINK Nội dung nghe nhìn về thực phẩm và đồ uống.
MENU Nội dung nghe nhìn trên trình đơn.
COMMON_AREA Nội dung nghe nhìn 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 đa phương tiệ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 đa phương tiện, tính bằng pixel.

heightPixels

integer

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 đa phương tiệ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 mục nội dung đa phương tiện được xem.

Phân bổ

Thông tin ghi công cho các mục nội dung đa phương tiệ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 đa phương tiện.

profilePhotoUrl

string

URL 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 mục nội dung đa phương tiện có thể bị báo cáo nếu nội dung đó không phù hợp.

profileUrl

string

URL 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 được chỉ định.

get

Trả về siêu dữ liệu của mục nội dung đa phương tiện được 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í.

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 MediaItemDataRef để tải mục nội dung đa phương tiện lên.