/api/v4/connected-accounts/{connectedAccountId}/foldersعرض مجلدات GMB لحساب متصل
يُرجع مجلدات Google Business Profile (المجموعات) التي يمكن لحساب Google متصل الوصول إليها.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| connectedAccountId | string | مطلوب | UUID of the connected Google account (from the list connected accounts endpoint). |
الاستجابات
200Array of GMB folder objects.
{ "data": { "getFoldersUnderGoogleAccount": [ { "folderId": "accounts/104890024806530350198", "folderName": "Aniruddha Basu", "locationCount": null } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
يُرجع المجلدات (المعروفة أيضًا باسم المجموعات أو مجموعات الحساب) في Google Business Profile التي يمكن لحساب Google المتصل الوصول إليها. يستخدم GBP المجلدات لتنظيم إدراجات الأنشطة التجارية ضمن حساب؛ ويحتوي كل مجلد على folderId وfolderName، وكذلك locationCount عندما توفره Google.
حالة استخدام: وضع إدراج نشاط تجاري جديد في المجلد المناسب. قبل استدعاء نقطة النهاية create-GMB-listing، اعرض مجلدات الحساب ودع العميل يختار أحدها. مرّر folderId المختار (السلسلة النصية accounts/{id}، التي تُستخدم دون تغيير) ليُنشأ إدراج النشاط التجاري الجديد داخل ذلك المجلد بدلًا من جذر الحساب.
حالة استخدام: المطابقة مع بنية GBP الخاصة بالعميل. غالبًا ما توزّع العلامات التجارية ذات المواقع المتعددة إدراجات الأنشطة التجارية على مجلدات. اجلب قائمة المجلدات لعرض التسلسل الهرمي الفعلي لـ GBP الخاص بالعميل في واجهة المستخدم لديك، وللتأكد من أنك تُجري المزامنة إلى المجلد الذي يتوقعه. لاحظ أن locationCount قد يكون null عندما لا تُرجع Google عددًا للمجلد، لذا تعامل معه بوصفه اختياريًا وليس مرجعًا معتمدًا. تتطلب نقطة النهاية هذه حسابًا متصلًا من نوع Google؛ والمسار صالح فقط لاتصالات GoogleAccount.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/folders' \ -H "Authorization: API $LISTINGSAPI_KEY"