Looker API 4.0이 Looker 22.4에서 정식 버전으로 제공된다는 소식을 전해드립니다. 정식 API 4.0 버전(API 4.0 GA)에는 여러 엔드포인트를 베타에서 공개 버전으로 승격하는 브레이킹 및 추가 변경사항이 여러 개 있습니다. 자세한 API 4.0 사양은 API 참조를 확인하세요. Looker 지원 및 커뮤니티 지원 SDK가 Looker API 4.0 GA 엔드포인트를 지원하도록 업데이트되었습니다. 자세한 내용은 API 및 SDK 지원 정책과 API 버전 관리를 참조하세요. 이 문서의 나머지 부분에서는 API 4.0 GA로 마이그레이션할 때 기대할 수 있는 브레이킹 체인지, 해결 방법, 기능을 간략하게 보여줍니다.
대상 독자
이 문서는 Looker 지원 SDK, 커뮤니티 지원 SDK 또는 API 자체를 통해 Looker API를 사용하는 경우 도움이 됩니다. 아래에서 사용 중인 Looker API 버전에 해당되는 섹션을 읽어보세요.
GA 이전 API 4.0 사용자
API 4.0을 사용하는 경우 이 섹션을 참조하세요. 여기에서는 API 4.0 GA로 마이그레이션할 때의 브레이킹 체인지와 사용 가능한 완화 방법을 다룹니다.
API 4.0 GA에서는 모든 항목 ID 필드가 숫자 integer 유형에서 string 유형으로 변경되었습니다. 예를 들어 GET /groups/{group_id}엔드포인트는 int64 유형 대신 string 유형으로 id를 반환합니다.
API 4.0 엔드포인트 사용과 관련된 영향 및 해결 방법을 보려면 다음 표를 검토하세요.
용도
잠재적 영향력1
예방 방법
Looker 모바일 앱
오래된 Looker 모바일 앱 설치가 작동을 중지합니다.
사용자가 최신 버전의 Looker 모바일 앱으로 업데이트하도록 합니다.
Looker 지원2 SDK
TypeScript SDK(4.0 API)
영향 없음
조치 불필요
Python SDK(4.0 API)
영향 없음
조치 불필요
Ruby SDK(4.0 API)
영향 없음
조치 불필요
커뮤니티 지원2 SDK
Swift SDK
런타임 예외
SDK를 v22.0 이상으로 업데이트, 이후 결과적으로 발생하는 유형 오류 해결(있는 경우)
Kotlin SDK
영향 없음
조치 불필요
LookR SDK
영향 없음
조치 불필요
C# SDK
영향 없음
조치 불필요
Go SDK
런타임 예외
SDK를 v22.0 이상으로 업데이트, 이후 결과적으로 발생하는 유형 오류 해결(있는 경우)
기타
SDK 없이(또는 외부에서 제공된 라이브러리로) 4.0 API 사용
언어 유형 민감도에 따른 가능한 런타임 오류
코드에서 ID 필드 유형에 대한 종속 항목을 검토하고 문자열 유형의 ID 필드 지원을 추가합니다. 또한 이 추가 안내를 검토하세요.
1: Looker의 ID 필드 사용을 포함할 수 있지만 ID에 숫자 연산을 적용하는 등 비정상적인 사용 패턴은 포함하지 않는 일반적인 사용 패턴을 가정합니다.
API 3.1을 사용하는 경우 이 섹션을 참조하세요. 여기에서는 API 4.0에서 사용할 수 있는 추가 기능과 변경사항을 다룹니다. 모든 Looker 지원 및 커뮤니티 지원 SDK는 기본적으로 API 4.0을 지원합니다. 자세한 내용은 SDK 및 API 지원 정책을 참조하세요.
API 4.0에 추가될 새로운 기능과 추가 변경사항을 예상할 수 있으며 API 참조에서 언제든지 최신 변경사항을 확인할 수 있습니다. 자세한 내용은 API 및 SDK 지원 정책과 API 버전 관리를 참조하세요. Google은 브레이킹 체인지가 이상적이지 않음을 알고 있습니다. 심각한 문제가 발생하지 않는 한 정식 버전인 API 4.0에 관한 어떤 브레이킹 체인지도 적용하지 않습니다. 정식 버전인 Looker API 4.0이 Looker 플랫폼에서 더 생산적으로 쉽게 개발하는 데 도움이 되기를 바랍니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-22(UTC)"],[],[],null,["# Looker API 4.0 Generally Available\n\nWe are excited to announce that Looker API 4.0 is generally available in Looker 22.4. The generally available API 4.0 (API 4.0 GA) has multiple breaking and additive changes and promotes multiple endpoints from Beta to Stable. Check out our [API reference](/looker/docs/reference/looker-api/latest) for detailed API 4.0 specs. We updated our Looker-supported and Community-supported SDKs to support Looker API 4.0 GA endpoints. For more information, see [API and SDK support policies](/looker/docs/api-sdk-support-policy) and [API Versioning](/looker/docs/api-versioning). The rest of this article outlines the breaking changes, mitigations, and features you can look forward to when migrating to API 4.0 GA.\n\nWho should read this?\n---------------------\n\nThis document is for you if you use the Looker API through Looker-supported SDKs, Community-supported SDKs, or the API itself. Read the following section that maps to the Looker API version you use.\n\nPre-GA API 4.0 Users\n--------------------\n\nIf you use API 4.0, read this section. It covers the breaking changes and available mitigations when you migrate to API 4.0 GA.\n\nAPI 4.0 GA includes changing all entity ID fields from numeric `integer` type to `string` type. For example, `GET /groups/{group_id}` [endpoint](/looker/docs/reference/looker-api/latest/methods/Group/group) returns `id` as type `string` instead of type `int64`.\n\nPlease read through the following table for impact and mitigations specific to your API 4.0 endpoint usage:\n\n1: Assuming common usage patterns that may include the use of Looker's ID fields, but not unusual usage patterns such as applying numeric operations to IDs.\n\n2: [Looker API \\& SDK support](/looker/docs/api-sdk-support-policy). Community-supported libraries are not officially supported by Looker.\n\nAPI 3.1 Users\n-------------\n\nIf you use API 3.1, read this section. It covers the additional features and changes that API 4.0 makes available to you. Keep in mind, all our Looker-supported and Community-supported SDKs mainly support API 4.0. See [SDK and API support policies](/looker/docs/api-sdk-support-policy) for more information.\n\n### Additional API 4.0 GA Features\n\nFor convenience, we list the most notable and useful additive API 4.0 changes for you:\n\n- [Board, board item, and board section creation and management](/looker/docs/reference/looker-api/latest/methods/Board). See the [Board documentation page](/looker/docs/presenting-content) for more information about boards.\n- Query additional connection info such as [databases](/looker/docs/reference/looker-api/latest/methods/Metadata/connection_databases), [schemas](/looker/docs/reference/looker-api/latest/methods/Metadata/connection_schemas), [columns](/looker/docs/reference/looker-api/latest/methods/Metadata/connection_columns), and [tables](/looker/docs/reference/looker-api/latest/methods/Metadata/connection_tables). Set and update additional connection fields.\n- OAuth apps and users creation and management. See the [OAuth documentation page](/looker/docs/api-cors) for more information about OAuth.\n- Search groups with [hierarchy](/looker/docs/reference/looker-api/latest/methods/Group/search_groups_with_hierarchy) and [roles](/looker/docs/reference/looker-api/latest/methods/Group/search_groups_with_roles).\n- [Search roles with user count](/looker/docs/reference/looker-api/latest/methods/Role/search_roles_with_user_count).\n- [Get](/looker/docs/reference/looker-api/latest/methods/Config/get_setting) and [set](/looker/docs/reference/looker-api/latest/methods/Config/set_setting) Looker instance settings. See the [Settings documentation page](/looker/docs/admin-panel-general-settings) for more information about settings.\n- [Alert creation and management](/looker/docs/reference/looker-api/latest/methods/Alert). See the [Alerts documentation page](/looker/docs/alerts-overview) for more information about alerts.\n- [SSH tunnels and SSH servers creation, management, and testing](/looker/docs/reference/looker-api/latest/methods/Connection). See the [SSH documentation page](/looker/docs/using-an-ssh-tunnel) for more information about SSH.\n- [Move](/looker/docs/reference/looker-api/latest/methods/Dashboard/move_dashboard) and [copy](/looker/docs/reference/looker-api/latest/methods/Dashboard/copy_dashboard) dashboards.\n- [Get relative URLs for new dashboards](/looker/docs/reference/looker-api/latest/methods/Dashboard/create_dashboard).\n- [Move](/looker/docs/reference/looker-api/latest/methods/Look/move_look) and [copy](/looker/docs/reference/looker-api/latest/methods/Look/copy_look) Looks.\n- [Signed embed](/looker/docs/single-sign-on-embedding) and non-signed embed secret, URL, and user creation and management.\n- [Get refresh token to refresh login access token](/looker/docs/reference/looker-api/latest/methods/ApiAuth/login).\n- Limit and offset the results from getting [all LookML models](/looker/docs/reference/looker-api/latest/methods/LookmlModel/all_lookml_models) and [all users](/looker/docs/reference/looker-api/latest/methods/User/all_users).\n- Limit and offset the results from [searching users](/looker/docs/reference/looker-api/latest/methods/User/search_users).\n- [Get the Looker instance API spec in Swagger 2.x JSON](/looker/docs/reference/looker-api/latest/methods/Config/api_spec).\n\n### API 4.0 GA Deprecation Changes\n\nAPI 4.0 GA replaces several deprecated API 3.1 endpoints with improved features. The following endpoints are affected:\n\n- Deprecated Homepage endpoints have been removed. Please make use of [board endpoints](/looker/docs/reference/looker-api/latest/methods/Board) instead of homepages. See [Presenting content with boards](/looker/docs/presenting-content).\n- Deprecated Space endpoints have been removed. Make use of [folder endpoints](/looker/docs/reference/looker-api/latest/methods/Folder) instead of Space. See [Organizing and managing access to content](/looker/docs/organizing-spaces).\n\nAPI 3.0 Users\n-------------\n\nAPI 3.0 is [deprecated](/looker/docs/api-3x-deprecation), and it is recommended you migrate to API 4.0.\n\n- Only API 4.0 supports all Looker-supported and Community-supported SDKs to ease your development. Check out our [SDK repository](https://github.com/looker-open-source/sdk-codegen).\n- API 4.0 introduces multiple new features and enhancements as listed in the [Additional API 4.0 GA Features section](#additional_api_40_ga_features) on this page.\n\nWrap-Up\n-------\n\nYou can look forward to new features and additive changes to be added to API 4.0 and you can always find the latest changes in our [API reference](/looker/docs/reference/looker-api/latest). For more information, see [API and SDK support policies](/looker/docs/api-sdk-support-policy) and [API Versioning](/looker/docs/api-versioning). We know that breaking changes are not ideal. Unless an extreme issue arises, we will not make any breaking changes to our generally available API 4.0. We hope our generally available Looker API 4.0 helps you develop more productively and easily on the Looker platform."]]
