Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: locations.placeActionLinks.patch
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیوند عمل مکان مشخص شده را به روز می کند و آن را برمی گرداند.
درخواست HTTP
PATCH https://mybusinessplaceactions.googleapis.com/v1/{placeActionLink.name=locations/*/placeActionLinks/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
placeActionLink.name | string اختیاری. نام منبع، در قالب locations/{locationId}/placeActionLinks/{place_action_link_id} . فیلد نام فقط در درخواست‌های placeActionLinks.patch و placeActionLinks.delete برای به‌روزرسانی و حذف پیوندها در نظر گرفته می‌شود. با این حال، در درخواست placeActionLinks.create نادیده گرفته می شود، جایی که place_action_link_id توسط سرور با ایجاد موفقیت آمیز پیوند جدید اختصاص داده می شود و به عنوان بخشی از پاسخ بازگردانده می شود. |
پارامترهای پرس و جو
| مولفه های |
|---|
updateMask | string ( FieldMask format) ضروری. فیلدهای خاص برای به روز رسانی تنها فیلدهای قابل ویرایش عبارتند از uri , placeActionType و isPreferred . اگر پیوند به روز شده از قبل در همان مکان با همان placeActionType و uri وجود داشته باشد، با یک خطای ALREADY_EXISTS خراب می شود. این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
درخواست بدن
بدنه درخواست شامل یک نمونه از PlaceActionLink است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از PlaceActionLink است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eUpdates a specified place action link with provided details and returns the updated link.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP request method and requires a \u003ccode\u003eplaceActionLink.name\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eupdateMask\u003c/code\u003e query parameter indicating the fields to be updated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003ePlaceActionLink\u003c/code\u003e object and a successful response will return the updated \u003ccode\u003ePlaceActionLink\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"]]],["This describes updating a place action link via a `PATCH` request to a specific URL: `https://mybusinessplaceactions.googleapis.com/v1/{placeActionLink.name=locations/*/placeActionLinks/*}`. Key actions include updating fields like `uri`, `placeActionType`, and `isPreferred` using the `updateMask` query parameter. The `placeActionLink.name` path parameter is necessary for identifying the link to modify. The request and response body use the `PlaceActionLink` resource. This operation requires `https://www.googleapis.com/auth/business.manage` authorization scope.\n"],null,["# Method: locations.placeActionLinks.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nUpdates the specified place action link and returns it.\n\n### HTTP request\n\n`PATCH https://mybusinessplaceactions.googleapis.com/v1/{placeActionLink.name=locations/*/placeActionLinks/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `placeActionLink.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\n### Query parameters\n\n| Parameters ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields to update. The only editable fields are `uri`, `placeActionType` and `isPreferred`. If the updated link already exists at the same location with the same `placeActionType` and `uri`, fails with an `ALREADY_EXISTS` error. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [PlaceActionLink](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionLink).\n\n### Response body\n\nIf successful, the response body contains an instance of [PlaceActionLink](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionLink).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
