تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.getGoogleUpdated
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على النسخة المعدّلة من Google للموقع الجغرافي المحدّد تعرض الدالة NOT_FOUND إذا لم يكن الموقع الجغرافي متوفرًا.
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:googleUpdated
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
اسم الموقع الذي تريد جلبه.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
يمثل موقعًا جغرافيًا عدّلته Google.
| تمثيل JSON |
{
"location": {
object (Location)
},
"diffMask": string
} |
| الحقول |
location |
object (Location)
النسخة المعدّلة من Google لهذا الموقع الجغرافي
|
diffMask |
string (FieldMask format)
الحقول التي عدّلتها Google. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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)."]]
