REST Resource: accounts.locations.media.customers

Zasób: MediaItem

Jeden 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 w przypadku wszystkich innych żądań jest tylko do odczytu. Tego ustawienia nie można później zmienić.

locationAssociation

object (LocationAssociation)

Wymagane przy dzwonieniu pod numer CreatePhoto. Opisuje, jak ten element multimedialny jest połączony ze swoją lokalizacją. Musi to być kategoria (np. EXTERIOR) lub identyfikator elementu listy cen.

Jest to wymagane, gdy dodajesz nowe multimedia do lokalizacji z użyciem media.create. Ta wartość nie będzie widoczna w przypadku innych typów multimediów, takich jak zdjęcia w lokalnych postach.

googleUrl

string

Tylko dane wyjściowe. Adres URL tego elementu multimedialnego na serwerze Google. Ten adres URL nie jest statyczny i może się zmieniać z czasem. W przypadku filmów jest to obraz podglądu z nałożoną ikoną odtwarzania.

thumbnailUrl

string

Tylko dane wyjściowe. Adres URL miniatury obrazu tego elementu multimedialnego (jeśli został podany).

createTime

string (Timestamp format)

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

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi 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 elementów multimedialnych klientów. Informacje o źródle muszą być widoczne dla użytkowników i nie wolno ich usuwać ani zmieniać.

description

string

Opis tego elementu multimedialnego. Opisów nie można modyfikować za pomocą interfejsu API Google Moja Firma, ale można je ustawiać podczas tworzenia nowego elementu multimedialnego, który nie jest zdjęciem na okładkę.

Pole sumy data. Źródło danych elementu multimedialnego. Podczas tworzenia nowego elementu multimedialnego trzeba podać adres URL lub odwołanie do danych.

Z wyjątkiem kategorii PROFILE i COVER wszystkie zdjęcia muszą mieć co najmniej 250 pikseli na krótszej krawędzi i rozmiar pliku co najmniej 10 240 bajtów.

Wszystkie przesyłane zdjęcia powinny być zgodne ze wskazówkami dotyczącymi 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 tego elementu lub musisz ustawić parametr dataRef, aby określić źródło elementu multimedialnego.

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

Tego pola nie można zaktualizować.

dataRef

object (MediaItemDataRef)

Tylko dane wejściowe. Odniesienie do danych binarnych elementów multimedialnych uzyskane za pomocą metody media.startUpload.

Podczas tworzenia elementu multimedialnego możesz

sourceUrl

lub

dataRef

musi być ustawiony.

Metody

get

Zwraca metadane żądanego elementu multimedialnego klienta.

list

Zwraca listę elementów multimedialnych powiązanych z lokalizacją, które zostały przekazane przez klientów.