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 dla tego elementu multimedialnego. accounts/{accountId}/locations/{locationId}/media/{mediaKey}

mediaFormat

enum (MediaFormat)

Format tego elementu multimedialnego. Należy go ustawić podczas tworzenia elementu multimedialnego. W przypadku wszystkich innych żądań ma ono status tylko do odczytu. Tego ustawienia nie można później zmienić.

locationAssociation

object (LocationAssociation)

Wymagane przy wywołaniu numeru CreatePhoto. Opisuje, w jaki sposób ten element multimedialny jest połączony ze swoją lokalizacją. Musi to być kategoria (np. EXTERIOR) lub identyfikator elementu z cennika.

Jest to wymagane, gdy dodajesz nowe multimedia do lokalizacji z atrybutem media.create. Ta informacja nie będzie widoczna w przypadku innych rodzajów multimediów, np. zdjęć w lokalnych postach.

googleUrl

string

Tylko dane wyjściowe. Hostowany przez Google adres URL tego elementu multimedialnego. Ten URL nie jest statyczny, ponieważ z czasem może się zmieniać. 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 elementu multimedialnego (jeśli podano).

createTime

string (Timestamp format)

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową 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 dotyczące elementów multimedialnych klienta. Informacje o autorze utworu muszą być udostępnione użytkownikom i nie wolno ich usuwać ani zmieniać.

description

string

Opis tego elementu multimedialnego. Opisów nie można modyfikować w interfejsie API Google Moja Firma, ale można je ustawić 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 należy podać adres URL lub odniesienie do danych.

Wszystkie zdjęcia (z wyjątkiem kategorii PROFILE i COVER) muszą mieć krótszą krawędź i rozmiar pliku co najmniej 10 240 bajtów, a jego długość musi wynosić co najmniej 250 pikseli.

Wszystkie przesyłane zdjęcia powinny być zgodne z wytycznymi Profilu Firmy dotyczącymi zdjęć. 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 parametru dataRef należy ustawić źródło, aby określić źródło elementu multimedialnego.

Jeśli podczas tworzenia elementu multimedialnego został użyty parametr sourceUrl, to podczas pobierania tego elementu pojawi się adres URL źródła.

Nie można zaktualizować tego pola.

dataRef

object (MediaItemDataRef)

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

Podczas tworzenia elementu multimedialnego:

sourceUrl

lub

dataRef

musi być ustawiony.

Metody

get

Zwraca metadane żądanego elementu multimedialnego klienta.

list

Zwraca listę elementów multimedialnych powiązanych z lokalizacją przesłanych przez klientów.