Interfejs
Google Business Performance API udostępnia
NOWĄ metodę interfejsu API, która umożliwia pobieranie wielu parametrów „DailyMetrics” w jednym żądaniu API.
Zapoznaj się z
harmonogramem wycofywania i instrukcjami, jak przejść z metody raportu API w wersji 4 na interfejs Google Business Profile Performance API.
REST Resource: locations.placeActionLinks
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: PlaceActionLink
Reprezentuje link do działania związanego z miejscem i jego atrybuty.
| Zapis JSON |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| Pola |
name |
string
Opcjonalnie: Nazwa zasobu w formacie locations/{locationId}/placeActionLinks/{place_action_link_id}. Pole „name” będzie uwzględniane tylko w żądaniach „placeActionLinks.patch” i „placeActionLinks.delete” w przypadku odpowiednio aktualizowania lub usuwania połączeń. Zostanie ona jednak zignorowana w żądaniu PlaceActionLinks.create, w którym serwer place_action_link_id zostanie przypisany przez serwer po utworzeniu nowego linku i zwrócony jako część odpowiedzi.
|
providerType |
enum (ProviderType)
Tylko dane wyjściowe. Określa typ dostawcy.
|
isEditable |
boolean
Tylko dane wyjściowe. Wskazuje, czy klient może edytować to połączenie.
|
uri |
string
Wymagane. Identyfikator URI linku. Tego samego identyfikatora URI można używać wielokrotnie dla różnych rodzajów działań w różnych lokalizacjach. Dla każdej unikalnej kombinacji identyfikatora (identyfikator URI, typ działania związanego z miejscem, lokalizacja) dozwolony jest jednak tylko 1 link do działania związanego z miejscem.
|
placeActionType |
enum (PlaceActionType)
Wymagane. Typ działania związanego z miejscem, które można wykonać przy użyciu tego połączenia.
|
isPreferred |
boolean
Opcjonalnie: Określa, czy sprzedawca preferuje ten link. Tylko 1 link można oznaczyć jako preferowane dla każdego typu działania związanego z miejscem w lokalizacji. Jeśli w przyszłej prośbie inny link oznaczy inny link jako preferowany dla tego samego typu działania związanego z miejscem, bieżący preferowany link (jeśli istnieje) utraci pierwszeństwo.
|
createTime |
string (Timestamp format)
Tylko dane wyjściowe. Godzina utworzenia linku do działania związanego z miejscem. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
Tylko dane wyjściowe. Czas ostatniej modyfikacji linku do działania związanego z miejscem. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
|
ProviderType
Typ dostawcy linku można tylko odczytać.
| Wartości w polu enum |
PROVIDER_TYPE_UNSPECIFIED |
Nie określono. |
MERCHANT |
Dostawca własny, np. sprzedawca lub agencja działająca w imieniu sprzedawcy. |
AGGREGATOR_3P |
Agregator firmy zewnętrznej, np. partner Reserve with Google. |
PlaceActionType
Typ działania związanego z miejscem, które można wykonać za pomocą linku.
| Wartości w polu enum |
PLACE_ACTION_TYPE_UNSPECIFIED |
Nie określono. |
APPOINTMENT |
Typ działania to rezerwowanie spotkania. |
ONLINE_APPOINTMENT |
Ten rodzaj działania to rezerwacja spotkania online. |
DINING_RESERVATION |
Ten typ działania to rezerwacja stolika w restauracji. |
FOOD_ORDERING |
Typ działania to zamawianie jedzenia na wynos lub z dostawą. |
FOOD_DELIVERY |
Typ działania to zamawianie jedzenia z dostawą. |
FOOD_TAKEOUT |
Typ działania to zamawianie jedzenia na wynos. |
SHOP_ONLINE |
Typ działania to Zakupy. Może to być dostawa lub odbiór. |
Metody |
|
|
Tworzy link do działania związanego z miejscem powiązany z określoną lokalizacją i zwraca go. |
|
|
Usuwa z określonej lokalizacji link do działania związanego z miejscem. |
|
|
Pobiera link do określonego działania związanego z miejscem. |
|
|
Zawiera listę linków do działań związanych z miejscem w przypadku określonej lokalizacji. |
|
|
Aktualizuje i zwraca podany link do działania związanego z miejscem. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
