Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.getGoogleUpdated
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
نسخه به‌روزرسانی‌شده Google مکان مشخص‌شده را دریافت می‌کند. اگر مکان وجود نداشته باشد، NOT_FOUND را برمی‌گرداند.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:googleUpdated
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
name | string نام مکان برای واکشی. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نشان دهنده مکانی است که توسط Google اصلاح شده است.
| نمایندگی JSON |
|---|
{
"location": {
object (Location)
},
"diffMask": string
} |
| فیلدها |
|---|
location | object ( Location ) نسخه به‌روزرسانی‌شده این مکان توسط Google. |
diffMask | string ( FieldMask format) فیلدهایی که گوگل به روز کرد. این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/plus.business.manage -
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\u003eRetrieves the Google-updated version of a specified location using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the location name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing the updated location data and a diff mask indicating the modified fields.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes retrieving a Google-updated location using a `GET` request to a specific URL (`https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:googleUpdated`). The `name` path parameter identifies the location. The request body must be empty. A successful response contains a JSON object with the updated location data, including the `location` object and a `diffMask` string that specifies changed fields. Authorization requires either the `plus.business.manage` or `business.manage` OAuth scope.\n"],null,["# Method: accounts.locations.getGoogleUpdated\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GoogleUpdatedLocation.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nGets the Google-updated version of the specified location. Returns `NOT_FOUND` if the location does not exist.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:googleUpdated`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------|\n| `name` | `string` The name of the location to fetch. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nRepresents a location that was modified by Google.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"location\": { object (/my-business/reference/rest/v4/accounts.locations#Location) }, \"diffMask\": string } ``` |\n\n| Fields ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[Location](/my-business/reference/rest/v4/accounts.locations#Location)`)` The Google-updated version of this location. |\n| `diffMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` The fields that Google updated. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\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)."]]
