실시간 업데이트를 하려면 Maps Booking API를 요청해야 합니다. Maps Booking API를 사용하려면 API에 액세스할 수 있고 필요한 QPS가 할당된 GCP 서비스 계정을 사용하여 OAuth 2.0을 통해 요청을 인증해야 합니다. 이 가이드에서는 다음 단계를 안내합니다.
Google Cloud 프로젝트 설정
서비스 계정 만들기
GCP 프로젝트에서 Maps Booking API 사용 설정
일반적인 문제 디버그
API를 요청하는 방법에 관한 자세한 내용은 예약 엔드 투 엔드 가이드의 실시간 API 업데이트 섹션을 참고하세요.
새 서비스 계정에 애플리케이션 요구사항에 가장 적합한 역할을 할당합니다.
서비스 계정의 역할 선택은 Google 지도 예약 API를 호출할 수 있는 항목에 영향을 미치지 않습니다. 사용하기 위한 충분한 할당량은 대신 액션 센터 구성에서 프로젝트 번호의 연결에 따라 결정되기 때문입니다.
어떤 역할을 선택해야 할지 잘 모르겠다면 프로젝트 > 뷰어를 선택하세요.
6단계에서 '계속'을 클릭하면 JSON 키를 만드는 옵션이 표시됩니다.
json 사용자 인증 정보를 저장합니다. 나중에 검색할 수 없으므로 안전한 장소에 보관해야 합니다.
파트너 포털에 다시 로그인하고 파트너 포털의 온보딩 작업 페이지에서 남은 작업을 완료합니다.
실시간 업데이트 요청을 할 때 승인 문제가 발생하는 이유는 다양합니다. 실시간 업데이트 요청을 하는 방법에 관한 일반적인 안내가 필요한 경우 예약 엔드 투 엔드 가이드의 실시간 API 업데이트 섹션을 참고하세요. 코드 샘플 섹션에서 여러 언어로 된 샘플 클라이언트도 확인할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eLeverage the Maps Booking API to implement real-time updates for your reservations, requiring authentication through a GCP service account.\u003c/p\u003e\n"],["\u003cp\u003eSet up your Google Cloud project, create a dedicated service account, and enable the necessary APIs following detailed instructions.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your service account has the required permissions and is properly authorized to access the Maps Booking API to prevent common errors.\u003c/p\u003e\n"],["\u003cp\u003eConsult the provided resources for troubleshooting common issues, including verifying authentication, scopes, and endpoints, and contact support for persistent errors.\u003c/p\u003e\n"],["\u003cp\u003eUtilize Google Client Libraries and OAuth Credentials with Service Account Authentication for seamless integration with the API.\u003c/p\u003e\n"]]],["To enable real-time updates via the Maps Booking API, you must first set up a Google Cloud project. This includes creating a service account, noting the project number and email, and enabling the Google Maps Booking API. Then create and save JSON keys for OAuth 2.0 authentication. Ensure proper authorization and use the correct API endpoint (Sandbox or Production). If issues persist, contact the Actions Center support, providing detailed project and request information.\n"],null,["# Authenticate with Maps Booking API\n\nIn order to make\n[real-time updates](/actions-center/verticals/reservations/e2e/integration-steps/real-time-api-updates), you need to make requests to the\n[Maps Booking API](/maps-booking/reference/maps-booking-api/rest). The Maps Booking API requires that you\nauthenticate your requests via OAuth 2.0 using a GCP service account which\nhas access to the API, and has been allocated the necessary QPS. This guide will walk you through the steps to:\n\n1. Set up your Google Cloud project\n2. Create a service account\n3. Enable the Maps Booking API in your GCP project\n4. Debug common issues\n\nFor information on how to make requests to the API, see our\n[real-time API updates](/actions-center/verticals/reservations/e2e/integration-steps/real-time-api-updates) section of the Reservations End-to-End guide.\n\nSetting up your Google Cloud project with the Actions Center\n------------------------------------------------------------\n\n| **Note:** If you have already set up your Partner Portal account, you must use the Google Cloud project that was entered as part of the setup. If you no longer have access to that Google Cloud Platform project, or need help identifying it, reach out to your Actions Center contact.\n\n1. Log in to your [Google Cloud Platform account](https://cloud.google.com/).\n2. You can [create a new project](https://support.google.com/googleapi/answer/6251787) or use an existing project for this purpose.\n - Please note down the cloud project number as you will require it in the next steps. Your cloud project number can also be found on Google Cloud Platform Home Page. The cloud project number is always numeric only.\n3. Log in to the [Partner Portal](https://partnerdash.google.com/apps/reservewithgoogle/onboarding).\n4. Complete step 1 on the Onboarding Tasks page of the Partner Portal by submitting the cloud project number and the cloud project email address (the email addressed used to administer the cloud project).\n\nCreating a Service Account and OAuth credentials\n------------------------------------------------\n\n| **Note:** These steps must be performed by the account with the developer email that was entered in the onboarding tasks steps.\n\n1. Log back into your [Google Cloud Platform account](https://cloud.google.com/).\n2. Navigate to [IAM \\& admin \\\u003e Service accounts](https://console.cloud.google.com/iam-admin/serviceaccounts).\n3. Search for your existing or newly created cloud project id.\n4. [Create](https://console.cloud.google.com/iam-admin/serviceaccounts/create) a service account.\n5. Fill out the service account details.\n6. Assign the new service account the role that is most suitable for your application needs. The choice of role for the service account will not have any effect on what calls can be made to the Google Maps Booking API, as the allocation of sufficient quota to use them is determined instead by the association of your project number in the Actions Center configuration. If you are unsure what role to pick, just pick Project \\\u003e Viewer.\n7. After clicking \"continue\" in step (6), you will be given an option to create JSON keys.\n8. Save the json credentials. Make sure to store these in a safe place, as you will not be able to retrieve them at a later time.\n9. Log back into Partner Portal and complete remaining tasks on the [Onboarding Tasks](https://partnerdash.google.com/apps/reservewithgoogle/onboarding) page of the Partner Portal.\n\nEnable the MapsBooking API\n--------------------------\n\n1. Log in to your [Google Cloud Platform account](https://cloud.google.com/).\n2. Navigate to [API \\& Services \\\u003e Dashboard](https://console.cloud.google.com/apis/dashboard).\n3. Click on [Enable APIs and Services](https://console.cloud.google.com/apis/library) and search for `Google Maps Booking API`.\n4. Enable the following APIs:\n - Google Maps Booking API\n - Google Maps Booking API (Dev)\n\n| **Note:** If you have already completed the onboarding steps and would like to update your existing cloud project to a new one, please reach out to your Actions Center contact.\n\nCommon Errors\n-------------\n\nThere are a variety of reasons that you may experience authorization issues\nwhen making Real-Time Update requests. If you need general guidance on how to\nmake Real-Time Updates requests, see our\n[real-time API updates](/actions-center/verticals/reservations/e2e/integration-steps/real-time-api-updates) section of the Reservations End-to-End guide. You can also find\nsample clients in multiple languages in the\n[Code Samples](/actions-center/verticals/reservations/e2e/reference/real-time-updates-rest/code-samples/code-sample)\nsection.\n\nIf you are encountering 403 errors, check that you are following all of the\nfollowing requirements:\n\n1. Use a [Google Client Library](/api-client-library).\n2. Create [OAuth Credentials using Service Account Auth](/identity/protocols/OAuth2ServiceAccount#authorizingrequests).\n3. Authorize against the **appropriate scope**.\n4. Make calls to the **appropriate endpoint** (listed below).\n\nEnsure you are **making calls to the correct endpoint:**\n\n1. Sandbox: `https://partnerdev-mapsbooking.googleapis.com/v1alpha/...`\n2. Production: `https://mapsbooking.googleapis.com/v1alpha/...`\n\nEnsure you are **authorizing your OAuth credentials requests properly:**\n\n1. You are authorizing against the scope \"https://www.googleapis.com/auth/mapsbooking\".\n2. You are using the service account key created in [Creating a Service Account and OAuth credentials](#creating-a-service-account-and-OAuth-credentials).\n\n### Still seeing errors?\n\nIf you are still seeing errors after following these steps,\nreach out to your Actions Center contact with the following information:\n\n- Cloud project number and project id with a screenshot\n- Service account id\n- Email used to create the service account\n- End-point details attempted to make requests to\n- Time of request attempts\n- Full request and error messages received when making requests."]]
