Für die
Google Business Performance API gibt es eine
NEUE API-Methode, mit der sich mehrere „DailyMetrics“-Objekte in einer einzelnen Anfrage abrufen lassen.
Sehen Sie sich den
Zeitplan für die Einstellung und die Anleitung für die Migration von der reportInsights API-Methode Version 4 zur Google Business Profile Performance API an.
REST Resource: locations.placeActionLinks
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: PlaceActionLink
Stellt einen Place Action-Link und die zugehörigen Attribute dar.
| JSON-Darstellung |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| Felder |
name |
string
Optional. Der Ressourcenname im Format locations/{locationId}/placeActionLinks/{place_action_link_id}. Das Feld „name“ wird nur in „placeActionLinks.patch“- und „placeActionLinks.delete“-Anfragen zum Aktualisieren bzw. Löschen von Links berücksichtigt. Sie wird jedoch bei der Anfrage „placeActionLinks.create“ ignoriert, bei der place_action_link_id nach erfolgreicher Erstellung eines neuen Links vom Server zugewiesen und als Teil der Antwort zurückgegeben wird.
|
providerType |
enum (ProviderType)
Nur Ausgabe. Gibt den Anbietertyp an.
|
isEditable |
boolean
Nur Ausgabe. Gibt an, ob dieser Link vom Client bearbeitet werden kann.
|
uri |
string
Erforderlich. Den Link-URI. Ein URI kann für verschiedene Aktionstypen an verschiedenen Standorten wiederverwendet werden. Für jede eindeutige Kombination aus (URI, Typ der Ortsaktion, Standort) ist jedoch nur ein Place Action-Link zulässig.
|
placeActionType |
enum (PlaceActionType)
Erforderlich. Die Art der Ortsaktion, die über diesen Link ausgeführt werden kann.
|
isPreferred |
boolean
Optional. Gibt an, ob dieser Link vom Händler bevorzugt wird. Pro ortsbezogener Aktionstyp an einem Standort kann nur ein Link als bevorzugt markiert werden. Wenn in einer zukünftigen Anfrage ein anderer Link für denselben Ort Aktionstyp als bevorzugt markiert wird, verliert der aktuelle bevorzugte Link (falls vorhanden) seine Einstellung.
|
createTime |
string (Timestamp format)
Nur Ausgabe. Der Zeitpunkt, zu dem der Link für die ortsbezogenen Aktionen erstellt wurde. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
Nur Ausgabe. Der Zeitpunkt, zu dem der Link für ortsbezogene Aktionen zuletzt geändert wurde. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
|
ProviderType
Der Typ des Linkanbieters, kann nur gelesen werden.
| Enums |
PROVIDER_TYPE_UNSPECIFIED |
Nicht angegeben. |
MERCHANT |
Ein Anbieter mit selbst erhobenen Daten, z. B. ein Händler oder eine Agentur im Namen eines Händlers |
AGGREGATOR_3P |
Ein Drittanbieter-Aggregator, z. B. ein Reserve with Google-Partner |
PlaceActionType
Die Art der Ortsaktion, die über den Link ausgeführt werden kann.
| Enums |
PLACE_ACTION_TYPE_UNSPECIFIED |
Nicht angegeben. |
APPOINTMENT |
Der Aktionstyp ist „Termin vereinbaren“. |
ONLINE_APPOINTMENT |
Der Aktionstyp ist „Onlinetermin vereinbaren“. |
DINING_RESERVATION |
Der Aktionstyp ist "Tischreservierung". |
FOOD_ORDERING |
Der Aktionstyp ist die Bestellung von Essen zur Lieferung und/oder zum Mitnehmen. |
FOOD_DELIVERY |
Der Aktionstyp ist „Essen zur Lieferung bestellen“. |
FOOD_TAKEOUT |
Der Aktionstyp ist „Essen zum Mitnehmen bestellen“. |
SHOP_ONLINE |
Der Aktionstyp ist „Shopping“, also „Lieferung“ und/oder „Abholung“. |
Methoden |
|
|
Erstellt einen Ortsaktionslink, der mit dem angegebenen Standort verknüpft ist, und gibt ihn zurück. |
|
|
Löscht einen Link für eine ortsbezogene Aktion am angegebenen Standort. |
|
|
Ruft den angegebenen Link für ortsbezogene Aktionen ab. |
|
|
Listet die Links für die Place Action des angegebenen Standorts auf. |
|
|
Aktualisiert den angegebenen Place Action-Link und gibt ihn zurück |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
