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 bersifat hanya-baca pada semua permintaan lainnya. Tidak dapat diperbarui.
locationAssociation

object (LocationAssociation)

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

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

string

Hanya output. URL yang dihosting Google untuk item media ini. URL ini tidak statis karena dapat berubah dari waktu ke 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 sebagaimana disediakan 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 referensi data harus diberikan.

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

Semua foto yang diupload harus mengikuti panduan Foto Profil Bisnis. data hanya ada berupa salah satu diantara berikut:
sourceUrl

string

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

Saat membuat salah satunya 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 kemudian 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 keduanya. location_attachment_type hanya ada berupa salah satu diantara berikut:
category

enum (Category)

Kategori yang sesuai dengan 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 satu 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 mengatribusikan item media.
profilePhotoUrl

string

URL thumbnail foto profil pengguna yang diatribusikan.
takedownUrl

string

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

string

URL halaman profil Google Maps untuk pengguna yang diatribusikan.

Metode

create

 Membuat item media baru untuk lokasi.

delete

 Menghapus item media tertentu.

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.