جلب المواقع حسب المعرّفات

الاسم	النوع	مطلوب	الوصف	الافتراضي
ids	string	مطلوب	JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value.	—

الاسم

النوع

مطلوب

الوصف

الافتراضي

ids

string

مطلوب

JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value.

—

الاستجابات

200Array of full location objects, one per resolved ID. Unknown IDs are omitted.

Response

{  "data": {    "getLocationsByIds": [      {        "id": "TG9jYXRpb246MTgwMDI4OQ==",        "databaseId": 1800289,        "accountId": 12345,        "storeId": null,        "name": "Jenny Home",        "archived": false,        "archivedAt": null,        "street": "600 Congress Ave, Suite 200",        "city": "Austin",        "stateIso": "TX",        "postalCode": "78701",        "countryIso": "US",        "countryCode": "1",        "latitude": "30.2711286",        "longitude": "-97.7436995",        "phone": "5125550142",        "additionalPhones": [],        "bizUrl": null,        "hideAddress": false,        "categoryId": 15,        "subCategoryId": 1432,        "subCategoryName": "Restaurants",        "additionalCategoryIds": [],        "description": "This is a standalone duplex house. A comfortable, private residence located in the Bouldin Creek neighborhood of Austin, offering spacious duplex living with easy access to the surrounding South Congress area and downtown Austin.",        "contentPreferredLanguage": "ENGLISH",        "businessHours": [],        "moreHours": [],        "package": "PREMIUM",        "planId": 3797,        "planName": "Launch",        "temporarilyClosed": false,        "ownerName": null,        "ownerEmail": null,        "paymentMethods": [],        "locationPhotos": [],        "isRestaurant": true,        "voiceStatus": 3,        "yearOfIncorporation": null,        "placeActionLinks": [          {            "placeActionType": "FOOD_ORDERING",            "uri": "https://order.example.com",            "isPreferred": true,            "name": "locations/1944.../placeActionLinks/54ada85bc246058a",            "submissionStatus": "success",            "submissionMessage": "Already up to date on Google.",            "lastSubmittedAt": "2026-07-08T12:14:36Z"          }        ],        "discoveredPlaceActionLinks": [          {            "placeActionType": "APPOINTMENT",            "uri": "https://book.example.com",            "isPreferred": false,            "name": "locations/1944.../placeActionLinks/abc123",            "providerType": "MERCHANT",            "isEditable": true          }        ]      }    ]  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

يجلب تفاصيل المواقع الكاملة لمجموعة محددة من المعرّفات في طلب واحد، بتكلفة أقل بكثير من تنفيذ GET مرة واحدة لكل موقع. يمكن جلب بيانات المواقع النشطة والمؤرشفة على حد سواء. مرّر المعرّفات كمصفوفة مرمّزة بصيغة JSON في معامل الاستعلام ids، وطبّق عليها ترميز URL.

حالة استخدام: جلب البيانات الكاملة لدفعة من المعرّفات الواردة من webhook أو مهمة. عندما تتلقى قائمة بمعرّفات المواقع (من مخزن البيانات الخاص بك، أو حمولة webhook، أو من المرور على صفحات قائمة المواقع)، اجلب بياناتها جميعًا دفعة واحدة: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. تُحذف المعرّفات غير الموجودة في حسابك من المصفوفة بصمت بدلًا من إرجاع خطأ، لذا قارن العدد المُعاد بالعدد الذي طلبته لاكتشاف المعرّفات التي لم تعد صالحة.

تنبيه: مفتاح الاستعلام هو ids. تقرأ نقطة النهاية هذه مصفوفة JSON من المعامل ids. تجميع عدة معرّفات في استدعاء واحد يُبقيك بعيدًا عن حد معدل الطلبات، بخلاف تنفيذ عمليات بحث منفردة في حلقة؛ وإذا نفّذتها بالتوازي، فالتزم بالترويسة Retry-After عند تلقي 429.

تتضمن البيانات المُعادة لكل موقع placeActionLinks (روابط الإجراءات على Google التي تديرها Listings API) وdiscoveredPlaceActionLinks (الروابط الموجودة مباشرةً في ملف النشاط التجاري على Google والتي لا تُدار بعد). راجع دليل روابط إجراءات الأماكن.

المعلمات

الاستعلام

الاستجابات