REST Resource: accounts.locations.media

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. Musi zostać ustawiony podczas tworzenia elementu multimedialnego, a w przypadku wszystkich innych żądań ma status tylko do odczytu. Tego ustawienia nie można później zmienić.
locationAssociation

object (LocationAssociation)

Wymagane przy wywołaniu numeru CreatePhoto. Opisuje sposób połączenia tego elementu multimedialnego 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 jego adres URL źródła zostanie uzupełniony podczas pobierania tego elementu.

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.

MediaItemDataRef

Odniesienie do danych binarnych zdjęć obiektu MediaItem przesłanego za pomocą interfejsu API Google Moja Firma.

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

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Unikalny identyfikator danych binarnych tego elementu multimedialnego. Służy do przesyłania danych zdjęć za pomocą polecenia [media.upload] oraz podczas tworzenia nowego elementu multimedialnego z tych bajtów za pomocą funkcji 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ń typu media.create ustaw tę wartość jako MediaItem dataRef.

MediaFormat

Enum formatu multimediów.

Wartości w polu enum
MEDIA_FORMAT_UNSPECIFIED Nie określono formatu.
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 jego 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 sumy location_attachment_type. Media z lokalizacją muszą mieć kategorię lub identyfikator elementu z cennika, z którym są powiązane. Pliki multimedialne niezwiązane z lokalizacją (np. zdjęcia z lokalnych postów) 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 z cennikiem, z którym jest powiązane to zdjęcie lokalizacji.

Kategoria

Enum kategorii elementu multimedialnego.

Wartości w polu enum
CATEGORY_UNSPECIFIED Nieokreślona kategoria.
COVER Zdjęcie na okładkę. Lokalizacja ma tylko jedno zdjęcie na okładkę.
PROFILE Zdjęcie profilowe. Lokalizacja ma tylko 1 zdjęcie profilowe.
EXTERIOR Materiały zewnętrzne.
INTERIOR Materiały wewnętrzne.
PRODUCT Multimedia dotyczące produktu.
AT_WORK W pracy multimediów.
FOOD_AND_DRINK Treści multimedialne związane z żywnością i napojami.
MENU Multimedia z menu.
COMMON_AREA Wspólne multimedia.
ROOMS Multimedia dotyczące pokoi.
TEAMS Multimedia związane z Teams.
ADDITIONAL Dodatkowe, niesklasyfikowane multimedia.

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 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 pochodzeniu danych dotyczących elementów multimedialnych klienta, np. imię i nazwisko współtwórcy oraz zdjęcie profilowe.

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

string

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

string

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

string

Adres URL strony usuwania treści, na której można zgłosić element multimedialny, jeśli jest on nieodpowiedni.
profileUrl

string

Adres URL strony profilu 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ę elementów multimedialnych powiązanych z lokalizacją.

patch

 Aktualizuje metadane określonego elementu multimedialnego.

startUpload

 Generuje plik MediaItemDataRef na potrzeby przesłania elementu multimedialnego.