Method: accounts.locations.associate
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משייך מיקום למזהה מקום. כל שיוך קודם יוחלף. הפעולה הזו תקפה רק אם המיקום לא מאומת. השיוך חייב להיות חוקי, כלומר הוא מופיע ברשימה של locations.findMatches.
בקשת HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:associate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
שם המשאב של המיקום לשיוך.
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג JSON |
{
"placeId": string
} |
| שדות |
placeId |
string
השיוך שצריך להקים. אם היא לא מוגדרת, סימן שאין התאמה.
|
גוף התשובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eThis operation associates a location to a place ID, overwriting any previous association, but is only valid for unverified locations and must be a valid match.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a POST method and gRPC Transcoding syntax, requiring the location's resource name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body uses JSON to specify the desired place ID for association or indicates no match if not set.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful association, the response body is empty, signaling completion.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes, either \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"]]],[],null,["# Method: accounts.locations.associate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nAssociates a location to a place ID. Any previous association is overwritten. This operation is only valid if the location is unverified. The association must be valid, that is, it appears in the list of `locations.findMatches`.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:associate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------|\n| `name` | `string` The resource name of the location to associate. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------|---|\n| ``` { \"placeId\": string } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------|\n| `placeId` | `string` The association to establish. If not set, it indicates no match. |\n\n### Response body\n\nIf successful, the response body is empty.\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)."]]
