REST Resource: locations.placeActionLinks
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: PlaceActionLink
מייצג קישור לפעולה לגבי מקום ואת המאפיינים שלו.
| ייצוג JSON |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| שדות |
name |
string
זה שינוי אופציונלי. שם המשאב, בפורמט locations/{locationId}/placeActionLinks/{place_action_link_id}. שדה השם ייחשב רק בבקשות לעדכון ולמחיקה של קישורים ב-placeActionLinks.patch וב-placeActionLinks.delete. עם זאת, המערכת תתעלם ממנו בבקשת actionsLinks.create, שבה השרת יוקצה ל-place_action_link_id אחרי יצירת קישור חדש ויוחזר כחלק מהתשובה.
|
providerType |
enum (ProviderType)
פלט בלבד. מציינת את סוג הספק.
|
isEditable |
boolean
פלט בלבד. השדה מציין אם הלקוח יכול לערוך את הקישור.
|
uri |
string
חובה. ה-URI של הקישור אפשר לעשות שימוש חוזר באותו URI לסוגי פעולות שונים במיקומים שונים. עם זאת, לכל שילוב ייחודי של (URI, סוג פעולה על מקום, מיקום) מותר להשתמש רק בקישור אחד לפעולה לגבי מקום.
|
placeActionType |
enum (PlaceActionType)
חובה. סוג הפעולה של מקום שאפשר לבצע באמצעות הקישור הזה.
|
isPreferred |
boolean
זה שינוי אופציונלי. אם הקישור הזה מועדף על ידי המוֹכר. ניתן לסמן קישור אחד בלבד כקישור מועדף לכל סוג פעולה של מקום במיקום מסוים. אם בקשה עתידית מסמנת קישור אחר כקישור מועדף באותו סוג פעולה לגבי מקום, הקישור המועדף הנוכחי (אם קיים) יאבד את ההעדפה שלו.
|
createTime |
string (Timestamp format)
פלט בלבד. השעה שבה נוצר הקישור לפעולה של המקום. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
פלט בלבד. השעה שבה בוצע השינוי האחרון בקישור לפעולה של המקום. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
|
ProviderType
סוג ספק הקישור – ניתן לקריאה בלבד.
| טיפוסים בני מנייה (enum) |
PROVIDER_TYPE_UNSPECIFIED |
לא צוין. |
MERCHANT |
ספק מאינטראקציה ישירה, כמו מוכר או סוכנות מטעם המוכר. |
AGGREGATOR_3P |
אתר אגרגטור של צד שלישי, כמו שותף Reserve with Google. |
PlaceActionType
סוג הפעולה של מקום שאפשר לבצע באמצעות הקישור.
| טיפוסים בני מנייה (enum) |
PLACE_ACTION_TYPE_UNSPECIFIED |
לא צוין. |
APPOINTMENT |
סוג הפעולה הוא קביעת פגישה. |
ONLINE_APPOINTMENT |
סוג הפעולה הוא קביעת פגישה באינטרנט. |
DINING_RESERVATION |
סוג הפעולה הוא הזמנת מקום במסעדה. |
FOOD_ORDERING |
סוג הפעולה הוא הזמנת אוכל במשלוח או באיסוף עצמי. |
FOOD_DELIVERY |
סוג הפעולה הוא הזמנת אוכל למשלוח. |
FOOD_TAKEOUT |
סוג הפעולה הוא הזמנת אוכל לטייק אוויי. |
SHOP_ONLINE |
סוג הפעולה הוא קנייה, שיכול להיות משלוח ו/או איסוף. |
שיטות |
|
|
יצירת קישור לפעולה לגבי מקום שמשויך למיקום שצוין, ומחזירה אותו. |
|
|
מחיקת קישור לפעולה של מקום מהמיקום שצוין. |
|
|
מקבל את הקישור שצוין לפעולה של המקום. |
|
|
בתיבת הדו-שיח הזו מפורטים הקישורים לפעולות לגבי המקום במיקום שצוין. |
|
|
עדכון הקישור לפעולה של המקום שצוין ומחזיר אותו. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
