Zasób: MediaItem
Jeden element multimedialny.
Zapis JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
Pola | ||
---|---|---|
name |
Nazwa zasobu tego elementu multimedialnego. |
|
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 |
Wymagane przy dzwonieniu pod numer Jest to wymagane, gdy dodajesz nowe multimedia do lokalizacji z użyciem |
|
googleUrl |
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 |
Tylko dane wyjściowe. Adres URL miniatury obrazu tego elementu multimedialnego (jeśli został podany). |
|
createTime |
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: |
|
dimensions |
Tylko dane wyjściowe. Wymiary (szerokość i wysokość) w pikselach. |
|
insights |
Tylko dane wyjściowe. Statystyki tego elementu multimedialnego. |
|
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 |
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 Z wyjątkiem kategorii Wszystkie przesyłane zdjęcia powinny być zgodne ze wskazówkami dotyczącymi Profilu Firmy. |
||
sourceUrl |
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 Tego pola nie można zaktualizować. |
|
dataRef |
Tylko dane wejściowe. Odniesienie do danych binarnych elementów multimedialnych uzyskane za pomocą metody Podczas tworzenia elementu multimedialnego możesz
lub
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 |
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 Przykład przesyłania bajtów: W przypadku połączeń typu |
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 |
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 |
Kategoria, do której należy to zdjęcie. |
|
priceListItemId |
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. |
LOGO |
Zdjęcie logo. |
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 |
Szerokość elementu multimedialnego w pikselach. |
heightPixels |
Wysokość elementu multimedialnego w pikselach. |
MediaInsights
Statystyki i statystyki dotyczące elementu multimedialnego.
Zapis JSON | |
---|---|
{ "viewCount": string } |
Pola | |
---|---|
viewCount |
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 |
Nazwa użytkownika, do którego zostanie przypisany element multimedialny. |
profilePhotoUrl |
Adres URL miniatury zdjęcia profilowego użytkownika. |
takedownUrl |
Adres URL strony z żądaniem usunięcia treści, na której można zgłosić element multimedialny, jeśli jest on nieodpowiedni. |
profileUrl |
Adres URL strony profilu w Mapach Google przypisanego użytkownika. |
Metody |
|
---|---|
|
Tworzy nowy element multimedialny dla danej lokalizacji. |
|
Usuwa określony element multimedialny. |
|
Zwraca metadane żądanego elementu multimedialnego. |
|
Zwraca listę elementów multimedialnych powiązanych z lokalizacją. |
|
Aktualizuje metadane określonego elementu multimedialnego. |
|
Generuje MediaItemDataRef na potrzeby przesyłania elementu multimedialnego. |