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, hal 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 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 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 merupakan 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 minimum 250 piksel pada tepi pendek, dengan ukuran file minimal 10.240 byte.

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

sourceUrl

string

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

Saat membuat salah satu dari ini atau dataRef harus disetel 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)

Input saja. 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 ref data menggunakan media.startUpload, dan gunakan ref ini saat mengupload byte ke [media.upload] lalu 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 upload 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 dapat berupa salah satu dari berikut:
category

enum (Category)

Kategori 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 'Di tempat kerja' lainnya.
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

Insight dan statistik untuk item media.

Representasi JSON
{
  "viewCount": string
}
Kolom
viewCount

string (int64 format)

Hanya output. Berapa kali item media telah 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 yang akan diatribusikan ke item media.

profilePhotoUrl

string

URL thumbnail foto profil pengguna yang diatribusikan.

takedownUrl

string

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

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.