مکان مشخصشده را همانطور که بهطور زنده در Google Maps و «جستجو» نشان داده میشود برمیگرداند. این نمای مشتریمحور ممکن است توسط Google یا محتوای تولیدشده توسط کاربر بهروز شده باشد و ممکن است با نسخه فروشنده متفاوت باشد. GoogleUpdatedLocation برگرداندهشده حاوی ماسکهایی است که نشان میدهد کدام فیلدها با اطلاعات فروشنده متفاوت است.
درخواست HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/{name=locations/*}:getGoogleUpdated
نشانی وب از نحو تراتبدیل gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
name |
الزامی. نام مکان برای واکشی. |
پارامترهای پُرسمان
| پارامترها | |
|---|---|
readMask |
الزامی. ماسک خواندن برای مشخص کردن اینکه کدام فیلدها در پاسخ برگردانده خواهند شد. این فهرست جداشده با کاما از نامهای کاملاً واجدشرایط فیلدها است. مثال: |
متن درخواست
بدنه درخواست باید خالی باشد.
بدنه پاسخ
نمایانگر نمای مکان بهصورتی است که برای مصرفکنندگان نمایش داده میشود، که شامل بهروزرسانیهایی است که درحالحاضر در Google Maps و «جستجو» ارائه میشود.
درصورت موفقیتآمیز بودن، بدنه پاسخ حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"location": {
object ( |
| فیلدها | |
|---|---|
location |
نسخه بهروزشده این مکان توسط Google. |
diffMask |
فیلدهایی که مقادیر آنها در نمایی که به مصرفکنندگان نشان داده میشود با اطلاعات فروشنده متفاوت است. برای پذیرفتن این تغییرات، مکان را وصله کنید. برای رد کردن، با مقادیر ترجیحیتان وصله کنید. این فهرست جداشده با کاما از نامهای کاملاً واجدشرایط فیلدها است. مثال: |
pendingMask |
فیلدهایی که فروشنده در آنها بهروزرسانیای ارائه کرده است که درحالحاضر درحال پردازش است و هنوز در Maps و «جستجو» منتشر نشده است. این ماسک فقط وضعیت ویرایشهای خود فروشنده را ردیابی میکند، نه تغییرات خارجی. این فهرست جداشده با کاما از نامهای کاملاً واجدشرایط فیلدها است. مثال: |
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به OAuth 2.0 Overview مراجعه کنید.