ID로 사업장 조회 | Listings API

이름	유형	필수	설명	기본값
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.

특정 ID 집합에 대한 전체 사업장 상세 정보를 한 번의 요청으로 가져오며, 사업장마다 GET 요청을 한 번씩 보내는 것보다 비용이 훨씬 적게 듭니다. 활성 사업장과 보관된 사업장 모두 조회할 수 있습니다. ID를 JSON으로 인코딩한 배열로 구성하고 URL 인코딩을 적용하여 ids 쿼리 매개변수로 전달합니다.

사용 사례: 웹훅이나 작업에서 받은 ID 묶음의 전체 정보 조회. 자체 저장소, 웹훅 페이로드 또는 페이지별 사업장 목록 크롤링을 통해 사업장 ID 목록을 받으면 한 번에 모두 조회합니다: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. 계정에 존재하지 않는 ID는 오류를 발생시키지 않고 배열에서 별도 알림 없이 제외되므로, 유효하지 않은 ID를 감지하려면 반환된 개수와 요청한 개수를 비교합니다.

주의 사항: 쿼리 키는 ids입니다. 이 엔드포인트는 ids 매개변수에서 JSON 배열을 읽습니다. 여러 ID를 한 번의 호출로 묶으면 개별 조회를 반복할 때보다 속도 제한에 걸릴 가능성이 훨씬 낮습니다. 개별 조회를 병렬로 실행하는 경우에는 429 응답의 Retry-After 헤더를 따릅니다.

각 사업장은 placeActionLinks(Listings API가 관리하는 Google 작업 링크)와 discoveredPlaceActionLinks(업체의 Google 프로필에서 직접 발견되었지만 아직 관리되지 않는 링크)를 반환합니다. 장소 작업 링크 가이드를 참조합니다.