L'API
Google Business Performance propose une
NOUVELLE méthode qui permet d'extraire plusieurs `DailyMetrics` avec une seule requête API.
Consultez le
planning d'abandon et les instructions pour migrer de la méthode API reportInsights v4 à l'API Google Business Profile Performance.
REST Resource: locations.placeActionLinks
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: PlaceActionLink
Représente un lien d'action pour un lieu et ses attributs.
| Représentation JSON |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| Champs |
name |
string
Facultatif. Nom de la ressource, au format locations/{locationId}/placeActionLinks/{place_action_link_id}. Le champ de nom ne sera pris en compte que dans les requêtes placeActionLinks.patch et placeActionLinks.delete pour la mise à jour et la suppression de liens, respectivement. Cependant, il sera ignoré dans la requête placeActionLinks.create, où place_action_link_id sera attribué par le serveur lors de la création réussie d'une association et renvoyé dans la réponse.
|
providerType |
enum (ProviderType)
Uniquement en sortie. Spécifie le type de fournisseur.
|
isEditable |
boolean
Uniquement en sortie. Indique si ce lien peut être modifié par le client.
|
uri |
string
Obligatoire. URI du lien. Le même URI peut être réutilisé pour différents types d'actions à différents endroits. Toutefois, un seul lien d'action pour un lieu est autorisé pour chaque combinaison unique de (URI, type d'action pour un lieu, lieu).
|
placeActionType |
enum (PlaceActionType)
Obligatoire. Type d'action relative à un lieu pouvant être effectué via ce lien.
|
isPreferred |
boolean
Facultatif. Indique si ce lien est préféré par le marchand. Un seul lien peut être marqué comme préféré par type d'action pour un lieu dans un établissement. Si, lors d'une future demande, un autre lien est marqué comme préféré pour le même type d'action liée à un lieu, le lien préféré actuel (le cas échéant) perdra sa préférence.
|
createTime |
string (Timestamp format)
Uniquement en sortie. Heure à laquelle le lien d'action pour un lieu a été créé. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
Uniquement en sortie. Heure de la dernière modification du lien d'action pour un lieu. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
|
ProviderType
Le type de fournisseur du lien ne peut être lu que.
| Enums |
PROVIDER_TYPE_UNSPECIFIED |
Non spécifié. |
MERCHANT |
Fournisseur propriétaire tel qu'un marchand, ou agence agissant pour le compte d'un marchand. |
AGGREGATOR_3P |
Un agrégateur tiers, tel qu'un partenaire Reserve with Google |
PlaceActionType
Type d'action pouvant être effectuée à l'aide d'un lieu à l'aide du lien.
| Enums |
PLACE_ACTION_TYPE_UNSPECIFIED |
Non spécifié. |
APPOINTMENT |
Le type d'action est la réservation d'un rendez-vous. |
ONLINE_APPOINTMENT |
Le type d'action est la réservation d'un rendez-vous en ligne. |
DINING_RESERVATION |
Le type d'action est "Effectuer une réservation au restaurant". |
FOOD_ORDERING |
Le type d'action est la commande de repas en livraison et/ou à emporter. |
FOOD_DELIVERY |
Le type d'action est la commande de repas en livraison. |
FOOD_TAKEOUT |
Le type d'action est "commander des repas à emporter". |
SHOP_ONLINE |
L'action est de type "Shopping" (livraison et/ou retrait en magasin). |
Méthodes |
|
|
Crée un lien d'action pour un lieu associé à l'établissement spécifié, puis l'affiche. |
|
|
Supprime un lien d'action pour un lieu à partir de l'établissement spécifié. |
|
|
Récupère le lien d'action pour un lieu spécifié. |
|
|
Répertorie les liens d'action pour l'établissement spécifié. |
|
|
Met à jour le lien d'action pour un lieu spécifié et l'affiche. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e resource represents a link associated with a Google Business Profile location, allowing customers to take actions like booking appointments or ordering food.\u003c/p\u003e\n"],["\u003cp\u003eLinks are categorized by \u003ccode\u003eProviderType\u003c/code\u003e (merchant, aggregator) and \u003ccode\u003ePlaceActionType\u003c/code\u003e (appointment, order, etc.) and can be managed through create, delete, get, list, and patch methods.\u003c/p\u003e\n"],["\u003cp\u003eEach link has attributes like \u003ccode\u003euri\u003c/code\u003e, \u003ccode\u003eisEditable\u003c/code\u003e, and \u003ccode\u003eisPreferred\u003c/code\u003e, providing control and information about the link's behavior and status.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e includes timestamps for creation and updates (\u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003eupdateTime\u003c/code\u003e) enabling tracking of link history.\u003c/p\u003e\n"]]],[],null,["# REST Resource: locations.placeActionLinks\n\n- [Resource: PlaceActionLink](#PlaceActionLink)\n - [JSON representation](#PlaceActionLink.SCHEMA_REPRESENTATION)\n- [ProviderType](#ProviderType)\n- [PlaceActionType](#PlaceActionType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PlaceActionLink\n-------------------------\n\nRepresents a place action link and its attributes.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"providerType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType), \"isEditable\": boolean, \"uri\": string, \"placeActionType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType), \"isPreferred\": boolean, \"createTime\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Optional. The resource name, in the format `locations/{locationId}/placeActionLinks/{place_action_link_id}`. The name field will only be considered in placeActionLinks.patch and placeActionLinks.delete requests for updating and deleting links respectively. However, it will be ignored in placeActionLinks.create request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response. |\n| `providerType` | `enum (`[ProviderType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType)`)` Output only. Specifies the provider type. |\n| `isEditable` | `boolean` Output only. Indicates whether this link can be edited by the client. |\n| `uri` | `string` Required. The link uri. The same uri can be reused for different action types across different locations. However, only one place action link is allowed for each unique combination of (uri, place action type, location). |\n| `placeActionType` | `enum (`[PlaceActionType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType)`)` Required. The type of place action that can be performed using this link. |\n| `isPreferred` | `boolean` Optional. Whether this link is preferred by the merchant. Only one link can be marked as preferred per place action type at a location. If a future request marks a different link as preferred for the same place action type, then the current preferred link (if any exists) will lose its preference. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was created. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\nProviderType\n------------\n\nThe type of the link provider, can only be read.\n\n| Enums ||\n|-----------------------------|-------------------------------------------------------------------------|\n| `PROVIDER_TYPE_UNSPECIFIED` | Not specified. |\n| `MERCHANT` | A 1P provider such as a merchant, or an agency on behalf of a merchant. |\n| `AGGREGATOR_3P` | A 3P aggregator, such as a `Reserve with Google` partner. |\n\nPlaceActionType\n---------------\n\nThe type of place action that can be performed using the link.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------|\n| `PLACE_ACTION_TYPE_UNSPECIFIED` | Not specified. |\n| `APPOINTMENT` | The action type is booking an appointment. |\n| `ONLINE_APPOINTMENT` | The action type is booking an online appointment. |\n| `DINING_RESERVATION` | The action type is making a dining reservation. |\n| `FOOD_ORDERING` | The action type is ordering food for delivery and/or takeout. |\n| `FOOD_DELIVERY` | The action type is ordering food for delivery. |\n| `FOOD_TAKEOUT` | The action type is ordering food for takeout. |\n| `SHOP_ONLINE` | The action type is shopping, that can be delivery and/or pickup. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/create) | Creates a place action link associated with the specified location, and returns it. |\n| ### [delete](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/delete) | Deletes a place action link from the specified location. |\n| ### [get](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/get) | Gets the specified place action link. |\n| ### [list](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/list) | Lists the place action links for the specified location. |\n| ### [patch](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/patch) | Updates the specified place action link and returns it. |"]]
