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.manage
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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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)."]]