REST Resource: accounts.locations.media

Resource: MediaItem

Satu item media.

Representasi 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.
}
Kolom
name

string

Nama resource untuk item media ini. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Format item media ini. Harus ditetapkan saat item media dibuat, dan berupa khusus-baca pada semua permintaan lainnya. Tidak dapat diperbarui.
locationAssociation

object (LocationAssociation)

Wajib diisi saat memanggil CreatePhoto. Menjelaskan bagaimana item media ini terhubung ke lokasinya. Harus berupa kategori (misalnya, EXTERIOR) atau ID item daftar harga.

Kolom ini diperlukan saat menambahkan media baru ke lokasi dengan media.create. Untuk jenis media lain, misalnya, foto pada postingan lokal, ini tidak akan ada.
googleUrl

string

Hanya output. URL yang dihosting oleh Google untuk item media ini. URL ini tidak statis karena dapat berubah seiring waktu. Untuk video ini akan menjadi gambar pratinjau dengan ikon putar overlay.
thumbnailUrl

string

Hanya output. Jika diberikan, URL gambar thumbnail untuk item media ini.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan item media ini.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Hanya output. Dimensi (lebar dan tinggi) dalam piksel.
insights

object (MediaInsights)

Hanya output. Statistik untuk item media ini.
attribution

object (Attribution)

Hanya output. Informasi atribusi untuk item media pelanggan. Anda harus menampilkan atribusi ini seperti yang diberikan kepada pengguna Anda dan tidak boleh menghapus atau mengubah atribusi tersebut.
description

string

Deskripsi untuk item media ini. Deskripsi tidak dapat diubah melalui Google My Business API, tetapi dapat ditetapkan saat membuat item media baru yang bukan foto sampul.

Kolom union data. Sumber data item media. Saat membuat item media baru, URL atau ref data harus disediakan.

Dengan pengecualian kategori PROFILE dan COVER, semua foto harus berukuran minimal 250px pada tepi pendek, dengan ukuran file minimal 10240 byte.

Semua foto yang diupload harus mengikuti pedoman foto Profil Bisnis. data hanya dapat berupa salah satu dari berikut:
sourceUrl

string

URL yang dapat diakses secara publik tempat item media dapat diambil.

Saat membuat, kolom ini atau dataRef harus ditetapkan untuk menentukan sumber item media.

Jika sourceUrl digunakan saat membuat item media, kolom ini akan diisi dengan URL sumber tersebut saat item media diambil.

Kolom ini tidak dapat diperbarui.
dataRef

object (MediaItemDataRef)

Hanya input. Referensi ke data biner item media seperti yang diperoleh dengan metode media.startUpload.

Saat membuat item media,

sourceUrl

atau

dataRef

harus ditetapkan.

MediaItemDataRef

Referensi ke data biner foto MediaItem yang diupload melalui Google My Business API.

Buat referensi data menggunakan media.startUpload, dan gunakan referensi ini saat mengupload byte ke [media.upload] dan selanjutnya memanggil media.create.

Representasi JSON 
{
  "resourceName": string
}
Kolom
resourceName

string

ID unik untuk data biner item media ini. Digunakan untuk mengupload data foto dengan [media.upload] dan saat membuat item media baru dari byte tersebut dengan media.create.

Contoh mengupload byte: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Untuk panggilan media.create, tetapkan ini sebagai MediaItem dataRef.

MediaFormat

Enum untuk format media.

Enum
MEDIA_FORMAT_UNSPECIFIED Format tidak ditentukan.
PHOTO Item media adalah foto. Dalam versi ini, hanya foto yang didukung.
VIDEO Item media adalah video.

LocationAssociation

Cara item media dikaitkan dengan lokasinya.

Representasi 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.
}
Kolom
Kolom union location_attachment_type. Media lokasi harus memiliki kategori atau ID item daftar harga yang terkait. Media non-lokasi (misalnya, foto postingan lokal) tidak boleh memiliki salah satunya. location_attachment_type hanya dapat berupa salah satu dari berikut:
category

enum (Category)

Kategori milik foto lokasi ini.
priceListItemId

string

ID item daftar harga yang dikaitkan dengan foto lokasi ini.

Kategori

Enum untuk kategori item media.

Enum
CATEGORY_UNSPECIFIED Kategori tidak ditentukan.
COVER Foto sampul. Lokasi hanya memiliki 1 foto sampul.
PROFILE Foto profil. Lokasi hanya memiliki satu foto profil.
EXTERIOR Media eksterior.
INTERIOR Media interior.
PRODUCT Media produk.
AT_WORK Media 'di tempat kerja'.
FOOD_AND_DRINK Media makanan dan minuman.
MENU Media menu.
COMMON_AREA Media area umum.
ROOMS Media ruang.
TEAMS Media tim.
ADDITIONAL Media tambahan yang tidak dikategorikan.

Dimensi

Dimensi item media.

Representasi JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Kolom
widthPixels

integer

Lebar item media, dalam piksel.
heightPixels

integer

Tinggi item media, dalam piksel.

MediaInsights

Analisis dan statistik untuk item media.

Representasi JSON 
{
  "viewCount": string
}
Kolom
viewCount

string (int64 format)

Hanya output. Frekuensi item media dilihat.

Atribusi

Informasi atribusi untuk item media pelanggan, seperti nama kontributor dan foto profil.

Representasi JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Kolom
profileName

string

Nama pengguna untuk atribut item media.
profilePhotoUrl

string

URL gambar mini foto profil pengguna yang dikaitkan.
takedownUrl

string

URL halaman penghapusan, tempat item media dapat dilaporkan jika tidak tepat.
profileUrl

string

URL halaman profil Google Maps untuk pengguna yang diatribusikan.

Metode

create

 Membuat item media baru untuk lokasi.

delete

 Menghapus item media yang ditentukan.

get

 Menampilkan metadata untuk item media yang diminta.

list

 Menampilkan daftar item media yang terkait dengan lokasi.

patch

 Memperbarui metadata untuk item media yang ditentukan.

startUpload

 Menghasilkan MediaItemDataRef untuk upload item media.