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 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.

MediaItemDataRef

Odniesienie do danych binarnych zdjęcia obiektu MediaItem przesłanego przy użyciu interfejsu API Google Moja Firma.

Utwórz odwołanie do danych za pomocą właściwości media.startUpload i użyj go podczas przesyłania bajtów do [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ęcia za pomocą metody [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

Wartość w przypadku formatu multimediów.

Wartości w polu enum
MEDIA_FORMAT_UNSPECIFIED Nie określono formatu.
PHOTO Element multimedialny jest zdjęciem. Ta wersja obsługuje 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 lokalizacji muszą mieć kategorię lub identyfikator elementu cennika, z którym są powiązane. Multimedia inne niż lokalizacja (np. zdjęcia w lokalnych wpisach) nie mogą zawierać żadnej z nich. location_attachment_type może mieć tylko jedną z tych wartości:
category

enum (Category)

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

string

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

Kategoria

Wyliczenie dla kategorii elementu multimedialnego.

Wartości w polu enum
CATEGORY_UNSPECIFIED Nieokreślona kategoria.
COVER Zdjęcie na okładkę. Lokalizacja ma tylko 1 zdjęcie na okładkę.
PROFILE Zdjęcie profilowe. Lokalizacja ma tylko jedno zdjęcie profilowe.
EXTERIOR Materiały zewnętrzne
INTERIOR Multimedia wewnętrzne.
PRODUCT Media produktowe.
AT_WORK Multimedia w pracy.
FOOD_AND_DRINK Media kulinarne.
MENU Multimedia menu.
COMMON_AREA Multimedia ogólnodostępne.
ROOMS Multimedia dotyczące pokoi.
TEAMS Multimedia dotyczące zespołów.
ADDITIONAL Dodatkowe multimedia, nieskategoryzowane

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 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 atrybucji elementów multimedialnych klientów, takie jak nazwa współtwórcy i zdjęcie profilowe.

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

string

Nazwa użytkownika, do którego zostanie przypisany element multimedialny.
profilePhotoUrl

string

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

string

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

string

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

Metody

create

 Tworzy nowy element multimedialny dla danej 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 MediaItemDataRef na potrzeby przesyłania elementu multimedialnego.