REST Resource: accounts.locations.media

Zasób: MediaItem

Pojedynczy element multimedialny.

Zapis 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.
}
Pola
name

string

Nazwa zasobu tego elementu multimedialnego. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Format tego elementu multimedialnego. Musi być ustawiony podczas tworzenia elementu multimedialnego i jest dostępny tylko do odczytu w przypadku wszystkich innych żądań. Tego ustawienia nie można później zmienić.
locationAssociation

object (LocationAssociation)

Wymagany podczas wywoływania funkcji CreatePhoto. Opisuje, jak ten element multimedialny jest powiązany z lokalizacją. Musi to być kategoria (np. EXTERIOR) lub identyfikator elementu cennika.

Jest to wymagane podczas dodawania nowych multimediów do lokalizacji z media.create. W przypadku innych typów multimediów, np. zdjęć w postach lokalnych, nie będzie on dostępny.
googleUrl

string

Tylko dane wyjściowe. Adres URL tego elementu multimedialnego hostowany przez Google. Ten adres URL nie jest statyczny, ponieważ może się z czasem zmieniać. W przypadku filmu będzie to obraz podglądu z nałożoną ikoną odtwarzania.
thumbnailUrl

string

Tylko dane wyjściowe. Adres URL miniatury tego elementu multimedialnego (jeśli jest dostępny).
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tego elementu multimedialnego.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund i maksymalnie 9 miejscami po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Tylko dane wyjściowe. Wymiary (szerokość i wysokość) w pikselach.
insights

object (MediaInsights)

Tylko dane wyjściowe. Statystyki tego elementu multimedialnego.
attribution

object (Attribution)

Tylko dane wyjściowe. Informacje o atrybucji w przypadku plików multimedialnych klienta. Musisz wyświetlać te informacje o autorstwie w formie, w jakiej zostały Ci przekazane, i nie możesz ich usuwać ani zmieniać.
description

string

Opis tego elementu multimedialnego. Opisów nie można modyfikować za pomocą interfejsu Google My Business API, ale można je ustawić podczas tworzenia nowego elementu multimedialnego, który nie jest zdjęciem głównym.

Pole zbiorcze data. Źródło danych elementu multimedialnego. Podczas tworzenia nowego elementu multimedialnego musisz podać adres URL lub odniesienie do danych.

Z wyjątkiem kategorii PROFILE i COVER wszystkie zdjęcia muszą mieć co najmniej 250 pikseli na krótszym boku, a rozmiar pliku musi wynosić co najmniej 10 240 bajtów.

Wszystkie przesłane zdjęcia powinny być zgodne z wytycznymi dotyczącymi zdjęć w Profilu Firmy. data może mieć tylko jedną z tych wartości:
sourceUrl

string

Publicznie dostępny adres URL, z którego można pobrać element multimedialny.

Podczas tworzenia jednego z tych elementów należy ustawić parametr dataRef, aby określić źródło elementu multimedialnego.

Jeśli podczas tworzenia elementu multimedialnego użyto parametru sourceUrl, po pobraniu elementu multimedialnego zostanie on wypełniony tym adresem URL źródła.

Tego pola nie można zaktualizować.
dataRef

object (MediaItemDataRef)

Tylko dane wejściowe. Odwołanie do danych binarnych elementu multimedialnego uzyskanych za pomocą metody media.startUpload.

Podczas tworzenia elementu multimedialnego możesz

sourceUrl

lub

dataRef

musi być ustawiona.

MediaItemDataRef

Odwołanie do binarnych danych zdjęcia MediaItem przesłanego za pomocą Google My Business API.

Utwórz odwołanie do danych za pomocą media.startUpload i użyj go podczas przesyłania bajtów do [media.upload], a następnie wywołaj media.create.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Unikalny identyfikator danych binarnych tego elementu multimedialnego. Używany do przesyłania danych zdjęć za pomocą [media.upload] i podczas tworzenia nowego elementu multimedialnego z tych bajtów za pomocą media.create.

Przykład przesyłania bajtów: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

W przypadku połączeń media.create ustaw to jako MediaItem dataRef.

MediaFormat

Wyliczenie formatu multimediów.

Wartości w polu enum
MEDIA_FORMAT_UNSPECIFIED Format nieokreślony.
PHOTO Element multimedialny to zdjęcie. W tej wersji obsługiwane są tylko zdjęcia.
VIDEO Element multimedialny to film.

LocationAssociation

Sposób powiązania elementu multimedialnego z lokalizacją.

Zapis 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.
}
Pola
Pole zbiorcze location_attachment_type. Media dotyczące lokalizacji muszą mieć kategorię lub identyfikator elementu cennika, z którym są powiązane. Pliki multimedialne niezwiązane z lokalizacją (np. zdjęcia w postach lokalnych) nie mogą zawierać żadnego z tych elementów. location_attachment_type może mieć tylko jedną z tych wartości:
category

enum (Category)

Kategoria, do której należy to zdjęcie lokalizacji.
priceListItemId

string

Identyfikator elementu listy cen, z którym jest powiązane to zdjęcie lokalizacji.

Kategoria

Wyliczenie kategorii elementu multimedialnego.

Wartości w polu enum
CATEGORY_UNSPECIFIED Kategoria nieokreślona.
COVER zdjęcie główne, Lokalizacja ma tylko jedno zdjęcie główne.
PROFILE Zdjęcie profilowe. Lokalizacja ma tylko 1 zdjęcie profilowe.
EXTERIOR Nośniki zewnętrzne.
INTERIOR Treści wewnątrz pojazdu.
PRODUCT Media produktu.
AT_WORK media „w pracy”;
FOOD_AND_DRINK media związane z jedzeniem i napoje,
MENU Media w menu.
COMMON_AREA Media w pomieszczeniach ogólnodostępnych.
ROOMS Media w pokojach.
TEAMS Media w Teams.
ADDITIONAL Dodatkowe, niekategoryzowane media.

Wymiary

Wymiary elementu multimedialnego.

Zapis JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Pola
widthPixels

integer

Szerokość elementu multimedialnego w pikselach.
heightPixels

integer

Wysokość elementu multimedialnego w pikselach.

MediaInsights

Statystyki i dane dotyczące elementu multimedialnego.

Zapis JSON 
{
  "viewCount": string
}
Pola
viewCount

string (int64 format)

Tylko dane wyjściowe. Liczba wyświetleń elementu multimedialnego.

Atrybucja

Informacje o atrybucji elementów multimedialnych klienta, takie jak imię i nazwisko autora oraz zdjęcie profilowe.

Zapis JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Pola
profileName

string

Nazwa użytkownika, do którego ma być przypisany element multimedialny.
profilePhotoUrl

string

Adres URL miniatury zdjęcia profilowego przypisanego użytkownika.
takedownUrl

string

Adres URL strony usunięcia, na której można zgłosić element multimedialny, jeśli jest nieodpowiedni.
profileUrl

string

Adres URL strony profilu przypisanego użytkownika w Mapach Google.

Metody

create

 Tworzy nowy element multimedialny dla lokalizacji.

delete

 Usuwa określony element multimedialny.

get

 Zwraca metadane żądanego elementu multimedialnego.

list

 Zwraca listę plików multimedialnych powiązanych z lokalizacją.

patch

 Aktualizuje metadane określonego elementu multimedialnego.

startUpload

 Generuje MediaItemDataRef do przesyłania elementu multimedialnego.