Ressource: MediaItem
Un seul élément multimédia.
Représentation JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
Champs | ||
---|---|---|
name |
Nom de ressource de cet élément multimédia. |
|
mediaFormat |
Format de cet élément multimédia. Doit être défini lors de la création de l'élément multimédia et est en lecture seule pour toutes les autres requêtes. Ce paramètre ne peut pas être modifié. |
|
locationAssociation |
Obligatoire pour l'appel de Cette étape est obligatoire lorsque vous ajoutez des contenus multimédias à un établissement avec |
|
googleUrl |
Uniquement en sortie. URL hébergée par Google pour cet élément multimédia. Cette URL n'est pas statique, car elle est susceptible de changer au fil du temps. Pour la vidéo, il s'agit d'un aperçu avec une icône de lecture superposée. |
|
thumbnailUrl |
Uniquement en sortie. URL d'une vignette de cet élément multimédia, si elle est fournie. |
|
createTime |
Uniquement en sortie. Date et heure de création de cet élément multimédia. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
|
dimensions |
Uniquement en sortie. Dimensions (largeur et hauteur) en pixels. |
|
insights |
Uniquement en sortie. Statistiques sur cet élément multimédia. |
|
attribution |
Uniquement en sortie. Informations sur l'attribution des éléments multimédias des clients. Vous devez afficher cette mention telle qu'elle a été fournie à vos utilisateurs, et vous ne devez pas la supprimer ni la modifier. |
|
description |
Description de cet élément multimédia. Vous ne pouvez pas modifier les descriptions via l'API Google My Business, mais vous pouvez les définir lors de la création d'un élément multimédia autre que la photo de couverture. |
|
Champ d'union À l'exception des catégories Toutes les photos importées doivent respecter les Consignes relatives aux photos sur les fiches d'établissement. |
||
sourceUrl |
URL accessible au public à partir de laquelle l'élément multimédia peut être récupéré. Lorsque vous créez l'un de ces éléments ou dataRef, vous devez définir la source de l'élément multimédia. Si Impossible de mettre à jour ce champ. |
|
dataRef |
Uniquement en entrée. Référence aux données binaires de l'élément multimédia obtenues par la méthode Lorsque vous créez un élément multimédia,
ou
doit être définie. |
MediaItemDataRef
Référence aux données binaires des photos d'un MediaItem
importé via l'API Google My Business.
Créez une référence de données à l'aide de media.startUpload
, puis utilisez-la lorsque vous importez des octets dans [media.upload], puis que vous appelez media.create
.
Représentation JSON | |
---|---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
ID unique des données binaires de cet élément multimédia. Permet d'importer les données des photos avec [media.upload] et de créer un élément multimédia à partir de ces octets avec Exemple d'importation d'octets: Pour les appels |
MediaFormat
Énumération pour le format du média.
Enums | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
Format non spécifié. |
PHOTO |
L'élément multimédia est une photo. Dans cette version, seules les photos sont prises en charge. |
VIDEO |
L'élément multimédia est une vidéo. |
LocationAssociation
La manière dont l'élément multimédia est associé à son emplacement.
Représentation JSON | |
---|---|
{ // Union field |
Champs | ||
---|---|---|
Champ d'union location_attachment_type . L'élément multimédia de l'établissement doit être associé à une catégorie ou à un ID d'article de liste de prix. Les éléments multimédias qui ne sont pas associés à l'établissement (par exemple, les photos des posts locaux) ne doivent contenir ni l'un ni l'autre. location_attachment_type ne peut être qu'un des éléments suivants : |
||
category |
Catégorie à laquelle appartient cette photo de lieu. |
|
priceListItemId |
Identifiant d'un article de liste de prix auquel cette photo d'établissement est associée. |
Catégorie
Énumération pour la catégorie d'élément multimédia.
Enums | |
---|---|
CATEGORY_UNSPECIFIED |
Catégorie non spécifiée. |
COVER |
Photo de couverture Un établissement n'a qu'une seule photo de couverture. |
PROFILE |
Photo du profil. Un établissement ne possède qu'une seule photo de profil. |
LOGO |
Photo du logo. |
EXTERIOR |
Élément multimédia extérieur. |
INTERIOR |
Élément multimédia représentant l'intérieur. |
PRODUCT |
Élément multimédia représentant le produit. |
AT_WORK |
Contenus multimédias au travail |
FOOD_AND_DRINK |
Élément multimédia représentant des aliments et des boissons. |
MENU |
Élément multimédia représentant un menu. |
COMMON_AREA |
Élément multimédia représentant les espaces communs. |
ROOMS |
Élément multimédia représentant les salles. |
TEAMS |
Élément multimédia représentant les équipes. |
ADDITIONAL |
Contenus multimédias supplémentaires sans catégorie. |
Dimensions
Dimensions de l'élément multimédia.
Représentation JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
Champs | |
---|---|
widthPixels |
Largeur de l'élément multimédia, en pixels. |
heightPixels |
Hauteur de l'élément multimédia, en pixels. |
MediaInsights
Insights et statistiques sur l'élément multimédia.
Représentation JSON | |
---|---|
{ "viewCount": string } |
Champs | |
---|---|
viewCount |
Uniquement en sortie. Nombre de fois où l'élément multimédia a été visionné. |
Attribution
Informations sur l'attribution associées aux éléments multimédias des clients, tels que le nom et la photo de profil d'un contributeur
Représentation JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
Champs | |
---|---|
profileName |
Nom d'utilisateur auquel attribuer l'élément multimédia. |
profilePhotoUrl |
URL de la vignette de la photo de profil de l'utilisateur attribué. |
takedownUrl |
URL de la page de retrait, sur laquelle l'élément multimédia peut être signalé s'il est inapproprié. |
profileUrl |
URL de la page de profil Google Maps de l'utilisateur attribué. |
Méthodes |
|
---|---|
|
Crée un élément multimédia pour l'établissement. |
|
Supprime l'élément multimédia spécifié. |
|
Affiche les métadonnées de l'élément multimédia demandé. |
|
Affiche la liste des éléments multimédias associés à un établissement. |
|
Met à jour les métadonnées de l'élément multimédia spécifié. |
|
Génère un MediaItemDataRef pour l'importation de l'élément multimédia. |