تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.lodging.getGoogleUpdated
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض أماكن إقامة Google المحدّثة لموقع جغرافي معين.
طلب HTTP
GET https://mybusinesslodging.googleapis.com/v1/{name=locations/*/lodging}:getGoogleUpdated
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. معرّف Google لهذا الموقع الجغرافي بالصيغة: locations/{locationId}/lodging
|
معامِلات طلب البحث
| المعلمات |
readMask |
string (FieldMask format)
مطلوب. الحقول المحدّدة المطلوب عرضها. استخدام "*" لتضمين جميع الحقول. لا يمكن تحديد عناصر الحقول المتكرّرة بشكل فردي. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ بشأن LodgingService.GetGoogleUpdatedLodging
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"lodging": {
object (Lodging)
},
"diffMask": string
} |
| الحقول |
lodging |
object (Lodging)
مطلوب. عدّلت Google أماكن الإقامة.
|
diffMask |
string (FieldMask format)
مطلوب. الحقول في "أماكن الإقامة" التي حدّثتها Google. لم يتم تحديد عناصر الحقول المتكرّرة بشكل فردي. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://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 lodging information for a specific location using a \u003ccode\u003eGET\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the location ID as a path parameter and optionally a field mask as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eReturns the lodging data and a diff mask indicating the fields updated by Google.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content describes retrieving Google-updated lodging information for a specific location using a `GET` HTTP request. The request requires a location `name` path parameter and a `readMask` query parameter to specify the desired fields. The request body must be empty. The response includes a `lodging` object representing the updated lodging data and a `diffMask` string, indicating which fields Google has updated. Accessing this data requires the `https://www.googleapis.com/auth/business.manage` OAuth scope.\n"],null,["# Method: locations.lodging.getGoogleUpdated\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 - [JSON representation](#body.GetGoogleUpdatedLodgingResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns the Google updated Lodging of a specific location.\n\n### HTTP request\n\n`GET https://mybusinesslodging.googleapis.com/v1/{name=locations/*/lodging}:getGoogleUpdated`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Google identifier for this location in the form: `locations/{locationId}/lodging` |\n\n### Query parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `readMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields to return. Use \"\\*\" to include all fields. Repeated field items cannot be individually specified. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for LodgingService.GetGoogleUpdatedLodging\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------|\n| ``` { \"lodging\": { object (/my-business/reference/lodging/rest/v1/Lodging) }, \"diffMask\": string } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `lodging` | `object (`[Lodging](/my-business/reference/lodging/rest/v1/Lodging)`)` Required. The Google updated Lodging. |\n| `diffMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The fields in the Lodging that have been updated by Google. Repeated field items are not individually specified. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\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)."]]
