تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
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. ومع ذلك، سيتم تجاهله في طلب PlaceActionLinks.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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
النتائج فقط. تشير هذه السمة إلى الوقت الذي تم فيه إجراء آخر تعديل على رابط الإجراء المستند إلى المكان. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
ProviderType
لا يمكن الاطّلاع إلا على نوع موفِّر الروابط.
| عمليات التعداد |
PROVIDER_TYPE_UNSPECIFIED |
لم يتم تحديده. |
MERCHANT |
مقدّم خدمة الطرف الأول، مثل التاجر أو الوكالة التي تنوب عن تاجر |
AGGREGATOR_3P |
موقع تجميع خارجي، مثل شريك Reserve with Google |
PlaceActionType
نوع الإجراء المستند إلى المكان الذي يمكن تنفيذه باستخدام الرابط.
| عمليات التعداد |
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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
