تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
