/api/v4/locations-by-idsKimliklere göre konumları getirin
Belirtilen konum kimlikleri kümesi için tüm konum bilgilerini tek bir istekte döndürür.
Parametreler
Sorgu
| Ad | Tür | Zorunlu | Açıklama | Varsayılan |
|---|---|---|---|---|
| ids | string | zorunlu | JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value. | — |
Yanıtlar
200Array of full location objects, one per resolved ID. Unknown IDs are omitted.
{ "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.
Belirli bir kimlik kümesi için tüm konum ayrıntılarını tek bir istekte getirir; bu, her konum için bir GET çağrısı yapmaktan çok daha düşük maliyetlidir. Hem etkin hem de arşivlenmiş konumlar getirilir. Kimlikleri ids sorgu parametresinde JSON olarak kodlanmış bir dizi şeklinde iletin ve bu diziye URL kodlaması uygulayın.
Kullanım senaryosu: bir webhook veya işten gelen kimlikleri toplu olarak konum bilgileriyle tamamlayın. Bir konum kimlikleri listesi aldığınızda (kendi veri deponuzdan, bir webhook yükünden veya sayfalandırılmış bir konum listesi taramasından), hepsine ait bilgileri tek seferde getirin: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. Hesabınızda bulunmayan kimlikler hata oluşturmak yerine sessizce diziden çıkarılır; bu nedenle artık geçerli olmayan kimlikleri tespit etmek için döndürülen öğe sayısını istediğiniz öğe sayısıyla karşılaştırın.
Dikkat: sorgu anahtarı ids değeridir. Bu uç nokta, JSON dizisini ids parametresinden okur. Çok sayıda kimliği tek bir çağrıda toplamak, tekil sorguları bir döngüde çalıştırmaya kıyasla istek hızı sınırının oldukça altında kalmanızı sağlar; sorguları paralel olarak gönderirseniz, 429 yanıtındaki Retry-After başlığına uyun.
Her konum için placeActionLinks (Listings API tarafından yönetilen Google işlem bağlantıları) ve discoveredPlaceActionLinks (doğrudan işletmenin Google profilinde bulunan ve henüz yönetilmeyen bağlantılar) döndürülür. Yer İşlem Bağlantıları kılavuzuna bakın.
curl -X GET 'https://listingsapi.com/api/v4/locations-by-ids?ids=<ids>' \ -H "Authorization: API $LISTINGSAPI_KEY"