looker-sdk 25.10.0__tar.gz → 25.18.0__tar.gz

{looker_sdk-25.10.0 → looker_sdk-25.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: looker_sdk
-Version: 25.10.0
+Version: 25.18.0
 Summary: Looker REST API
 Home-page: https://pypi.python.org/pypi/looker_sdk
 Author: Looker Data Sciences, Inc.

{looker_sdk-25.10.0 → looker_sdk-25.18.0}/looker_sdk/rtl/serialize.py

@@ -37,6 +37,7 @@ from typing import (
 )
 
 import cattr
+from cattrs.cols import is_sequence, list_structure_factory
 
 from looker_sdk.rtl import model, hooks
 
@@ -67,6 +68,7 @@ def deserialize(
     except json.JSONDecodeError as ex:
         raise DeserializeError(f"Bad json {ex}")
     try:
+        converter.register_structure_hook_factory(is_sequence, list_structure_factory)
         response: TDeserializeReturn = converter.structure(  # type: ignore
             data, structure
         )

{looker_sdk-25.10.0 → looker_sdk-25.18.0}/looker_sdk/sdk/api40/methods.py

@@ -21,7 +21,7 @@
 # SOFTWARE.
 #
 
-# 471 API methods
+# 476 API methods
 
 
 # NOTE: Do not edit this file generated by Looker SDK Codegen for API 4.0
@@ -417,7 +417,10 @@ class Looker40SDK(api_methods.APIMethods):
     #
     # See 'login' for more detail on the access token and how to use it.
     #
-    # Calls to this endpoint may be denied by [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview).
+    # In [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview) this call will be denied unless all of the following criteria are met:
+    #   1. The calling user is an [API-only Service Account](https://cloud.google.com/looker/docs/looker-core-user-management#creating_an_api-only_service_account) with the Admin role
+    #   2. The target user is an [Embed User type](https://cloud.google.com/looker/docs/r/single-sign-on-embedding)
+    # Regular user types can not be impersonated in [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview). If your application needs to call the API for these users, use OAuth authentication instead.
     #
     # POST /login/{user_id} -> mdls.AccessToken
     def login_user(
@@ -4102,16 +4105,18 @@ class Looker40SDK(api_methods.APIMethods):
         self,
         # Match content favorite id(s)
         id: Optional[str] = None,
-        # Match user id(s).To create a list of multiple ids, use commas as separators
+        # Match user id(s). To create a list of multiple ids, use commas as separators
         user_id: Optional[str] = None,
-        # Match content metadata id(s).To create a list of multiple ids, use commas as separators
+        # Match content metadata id(s). To create a list of multiple ids, use commas as separators
         content_metadata_id: Optional[str] = None,
-        # Match dashboard id(s).To create a list of multiple ids, use commas as separators
+        # Match dashboard id(s). To create a list of multiple ids, use commas as separators
         dashboard_id: Optional[str] = None,
-        # Match look id(s).To create a list of multiple ids, use commas as separators
+        # Match look id(s). To create a list of multiple ids, use commas as separators
         look_id: Optional[str] = None,
-        # Match board id(s).To create a list of multiple ids, use commas as separators
+        # Match board id(s). To create a list of multiple ids, use commas as separators
         board_id: Optional[str] = None,
+        # If true, and board_id is provided, returns the content favorites for all items on the board. If false, returns the content favorite for the board itself.
+        include_board_items: Optional[bool] = None,
         # Number of results to return. (used with offset)
         limit: Optional[int] = None,
         # Number of results to skip before returning any. (used with limit)
@@ -4137,6 +4142,7 @@ class Looker40SDK(api_methods.APIMethods):
                     "dashboard_id": dashboard_id,
                     "look_id": look_id,
                     "board_id": board_id,
+                    "include_board_items": include_board_items,
                     "limit": limit,
                     "offset": offset,
                     "sorts": sorts,
@@ -5022,6 +5028,76 @@ class Looker40SDK(api_methods.APIMethods):
         )
         return response
 
+    # ### Search LookML Dashboards
+    #
+    # Returns an array of **LookML Dashboard** objects that match the specified search criteria.
+    # Note, this only returns LookML Dashboards in production.
+    #
+    # If multiple search params are given and `filter_or` is FALSE or not specified,
+    # search params are combined in a logical AND operation.
+    # Only rows that match *all* search param criteria will be returned.
+    #
+    # If `filter_or` is TRUE, multiple search params are combined in a logical OR operation.
+    # Results will include rows that match **any** of the search criteria.
+    #
+    # String search params use case-insensitive matching.
+    # String search params can contain `%` and '_' as SQL LIKE pattern match wildcard expressions.
+    # example="dan%" will match "danger" and "Danzig" but not "David"
+    # example="D_m%" will match "Damage" and "dump"
+    #
+    # Integer search params can accept a single value or a comma separated list of values. The multiple
+    # values will be combined under a logical OR operation - results will match at least one of
+    # the given values.
+    #
+    # Most search params can accept "IS NULL" and "NOT NULL" as special expressions to match
+    # or exclude (respectively) rows where the column is null.
+    #
+    # Boolean search params accept only "true" and "false" as values.
+    #
+    #
+    # The parameters `limit`, and `offset` are recommended for fetching results in page-size chunks.
+    #
+    # Get a **single LookML dashboard** by id with [dashboard_lookml()](#!/Dashboard/dashboard_lookml)
+    #
+    # GET /dashboards/lookml/search -> mdls.DashboardLookml
+    def search_lookml_dashboards(
+        self,
+        # Filter on a particular folder.
+        folder_id: Optional[str] = None,
+        # Match LookML Dashboard title.
+        title: Optional[str] = None,
+        # Filter on a content favorite id.
+        content_favorite_id: Optional[str] = None,
+        # Requested fields.
+        fields: Optional[str] = None,
+        # Number of results to return. (used with offset and takes priority over page and per_page)
+        limit: Optional[int] = None,
+        # Number of results to skip before returning any. (used with limit and takes priority over page and per_page)
+        offset: Optional[int] = None,
+        # One or more fields to sort by. Sortable fields: [:title, :id, :folder_id, :content_favorite_id, :content_metadata_id]
+        sorts: Optional[str] = None,
+        transport_options: Optional[transport.TransportOptions] = None,
+    ) -> mdls.DashboardLookml:
+        """Search LookML Dashboards"""
+        response = cast(
+            mdls.DashboardLookml,
+            self.get(
+                path="/dashboards/lookml/search",
+                structure=mdls.DashboardLookml,
+                query_params={
+                    "folder_id": folder_id,
+                    "title": title,
+                    "content_favorite_id": content_favorite_id,
+                    "fields": fields,
+                    "limit": limit,
+                    "offset": offset,
+                    "sorts": sorts,
+                },
+                transport_options=transport_options,
+            ),
+        )
+        return response
+
     # ### Get lookml of a UDD
     #
     # Returns a JSON object that contains the dashboard id and the full lookml
@@ -6978,6 +7054,30 @@ class Looker40SDK(api_methods.APIMethods):
         )
         return response
 
+    # Checks to see if the user is able to connect to their integration hub
+    #
+    # GET /integration_hubs/{integration_hub_id}/health -> mdls.IntegrationHubHealthResult
+    def get_integration_hub_health(
+        self,
+        # Id of integration_hub
+        integration_hub_id: str,
+        # Requested fields.
+        fields: Optional[str] = None,
+        transport_options: Optional[transport.TransportOptions] = None,
+    ) -> mdls.IntegrationHubHealthResult:
+        """Check the health of Integration Hub"""
+        integration_hub_id = self.encode_path_param(integration_hub_id)
+        response = cast(
+            mdls.IntegrationHubHealthResult,
+            self.get(
+                path=f"/integration_hubs/{integration_hub_id}/health",
+                structure=mdls.IntegrationHubHealthResult,
+                query_params={"fields": fields},
+                transport_options=transport_options,
+            ),
+        )
+        return response
+
     # Accepts the legal agreement for a given integration hub. This only works for integration hubs that have legal_agreement_required set to true and legal_agreement_signed set to false.
     #
     # POST /integration_hubs/{integration_hub_id}/accept_legal_agreement -> mdls.IntegrationHub
@@ -7988,7 +8088,7 @@ class Looker40SDK(api_methods.APIMethods):
 
     # ### Fetches a CI Run.
     #
-    # GET /projects/{project_id}/ci/runs/{run_id} -> mdls.ProjectCIRun
+    # GET /projects/{project_id}/ci/runs/{run_id} -> mdls.ProjectRun
     def get_ci_run(
         self,
         # Project Id
@@ -7998,15 +8098,15 @@ class Looker40SDK(api_methods.APIMethods):
         # Requested fields
         fields: Optional[str] = None,
         transport_options: Optional[transport.TransportOptions] = None,
-    ) -> mdls.ProjectCIRun:
+    ) -> mdls.ProjectRun:
         """Fetch Continuous Integration run"""
         project_id = self.encode_path_param(project_id)
         run_id = self.encode_path_param(run_id)
         response = cast(
-            mdls.ProjectCIRun,
+            mdls.ProjectRun,
             self.get(
                 path=f"/projects/{project_id}/ci/runs/{run_id}",
-                structure=mdls.ProjectCIRun,
+                structure=mdls.ProjectRun,
                 query_params={"fields": fields},
                 transport_options=transport_options,
             ),
@@ -10345,6 +10445,8 @@ class Looker40SDK(api_methods.APIMethods):
         fields: Optional[str] = None,
         # Optional list of ids to get specific roles.
         ids: Optional[mdls.DelimSequence[str]] = None,
+        # Get all Looker support roles.
+        get_all_support_roles: Optional[bool] = None,
         transport_options: Optional[transport.TransportOptions] = None,
     ) -> Sequence[mdls.Role]:
         """Get All Roles"""
@@ -10353,7 +10455,11 @@ class Looker40SDK(api_methods.APIMethods):
             self.get(
                 path="/roles",
                 structure=Sequence[mdls.Role],
-                query_params={"fields": fields, "ids": ids},
+                query_params={
+                    "fields": fields,
+                    "ids": ids,
+                    "get_all_support_roles": get_all_support_roles,
+                },
                 transport_options=transport_options,
             ),
         )
@@ -10423,8 +10529,6 @@ class Looker40SDK(api_methods.APIMethods):
         built_in: Optional[bool] = None,
         # Combine given search criteria in a boolean OR expression.
         filter_or: Optional[bool] = None,
-        # Search for Looker support roles.
-        is_support_role: Optional[bool] = None,
         transport_options: Optional[transport.TransportOptions] = None,
     ) -> Sequence[mdls.Role]:
         """Search Roles"""
@@ -10442,7 +10546,6 @@ class Looker40SDK(api_methods.APIMethods):
                     "name": name,
                     "built_in": built_in,
                     "filter_or": filter_or,
-                    "is_support_role": is_support_role,
                 },
                 transport_options=transport_options,
             ),
@@ -12008,13 +12111,13 @@ class Looker40SDK(api_methods.APIMethods):
         first_name: Optional[str] = None,
         # Match Last name.
         last_name: Optional[str] = None,
-        # Search for user accounts associated with Looker employees
+        # Search for user accounts associated with Looker employees. Availability of this filter is limited to users with permission to view complete user details.
         verified_looker_employee: Optional[bool] = None,
         # Search for only embed users
         embed_user: Optional[bool] = None,
-        # Search for the user with this email address
+        # Search for the user with this email address. Availability of this filter is limited to users with permission to view complete user details.
         email: Optional[str] = None,
-        # Search for disabled user accounts
+        # Search for disabled user accounts. Availability of this filter is limited to users with permission to view complete user details.
         is_disabled: Optional[bool] = None,
         # Combine given search criteria in a boolean OR expression
         filter_or: Optional[bool] = None,
@@ -12022,6 +12125,10 @@ class Looker40SDK(api_methods.APIMethods):
         content_metadata_id: Optional[str] = None,
         # Search for users who are direct members of this group
         group_id: Optional[str] = None,
+        # Search for users who can manage API3 credentials. This field may only be applicable for [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview). Availability of this filter is limited to users with permission to view complete user details. This is an experimental feature and may not yet be available on your instance.
+        can_manage_api3_creds: Optional[bool] = None,
+        # Search for service account users. Send true to get only service accounts, or false to get all other types of users. This field may only be applicable for [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview). Availability of this filter is limited to users with permission to view complete user details. This is an experimental feature and may not yet be available on your instance.
+        is_service_account: Optional[bool] = None,
         transport_options: Optional[transport.TransportOptions] = None,
     ) -> Sequence[mdls.User]:
         """Search Users"""
@@ -12047,6 +12154,8 @@ class Looker40SDK(api_methods.APIMethods):
                     "filter_or": filter_or,
                     "content_metadata_id": content_metadata_id,
                     "group_id": group_id,
+                    "can_manage_api3_creds": can_manage_api3_creds,
+                    "is_service_account": is_service_account,
                 },
                 transport_options=transport_options,
             ),
@@ -12658,6 +12767,37 @@ class Looker40SDK(api_methods.APIMethods):
         )
         return response
 
+    # ### API login information for the specified user. This is for the newer API keys that can be added for any user.
+    #
+    # Calls to this endpoint may be denied by [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview).
+    #
+    # PATCH /users/{user_id}/credentials_api3/{credentials_api3_id} -> mdls.CredentialsApi3
+    def update_user_credentials_api3(
+        self,
+        # Id of user
+        user_id: str,
+        # Id of API Credential
+        credentials_api3_id: str,
+        body: mdls.WriteCredentialsApi3,
+        # Requested fields.
+        fields: Optional[str] = None,
+        transport_options: Optional[transport.TransportOptions] = None,
+    ) -> mdls.CredentialsApi3:
+        """Update API Credential"""
+        user_id = self.encode_path_param(user_id)
+        credentials_api3_id = self.encode_path_param(credentials_api3_id)
+        response = cast(
+            mdls.CredentialsApi3,
+            self.patch(
+                path=f"/users/{user_id}/credentials_api3/{credentials_api3_id}",
+                structure=mdls.CredentialsApi3,
+                query_params={"fields": fields},
+                body=body,
+                transport_options=transport_options,
+            ),
+        )
+        return response
+
     # ### API login information for the specified user. This is for the newer API keys that can be added for any user.
     #
     # Calls to this endpoint may be denied by [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview).
@@ -13233,6 +13373,61 @@ class Looker40SDK(api_methods.APIMethods):
         )
         return response
 
+    # ### Create a service account with the specified information. This action is restricted to Looker admins.
+    #
+    # Calls to this endpoint may only be available for [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview).
+    #
+    # POST /users/service_accounts -> mdls.ServiceAccount
+    def create_service_account(
+        self,
+        body: mdls.WriteServiceAccount,
+        # Requested fields.
+        fields: Optional[str] = None,
+        transport_options: Optional[transport.TransportOptions] = None,
+    ) -> mdls.ServiceAccount:
+        """Create Service Account"""
+        response = cast(
+            mdls.ServiceAccount,
+            self.post(
+                path="/users/service_accounts",
+                structure=mdls.ServiceAccount,
+                query_params={"fields": fields},
+                body=body,
+                transport_options=transport_options,
+            ),
+        )
+        return response
+
+    # ### Update information for a specific service account. This action is restricted to Looker admins.
+    #
+    # This endpoint is exclusively for updating service accounts. To update a regular user, please use the `PATCH /api/3.x/users/:user_id` endpoint instead.
+    #
+    # Calls to this endpoint may only be available for [Looker (Google Cloud core)](https://cloud.google.com/looker/docs/r/looker-core/overview).
+    #
+    # PATCH /users/service_accounts/{user_id} -> mdls.ServiceAccount
+    def update_service_account(
+        self,
+        # Id of service account
+        user_id: str,
+        body: mdls.WriteServiceAccount,
+        # Requested fields.
+        fields: Optional[str] = None,
+        transport_options: Optional[transport.TransportOptions] = None,
+    ) -> mdls.ServiceAccount:
+        """Update Service Account"""
+        user_id = self.encode_path_param(user_id)
+        response = cast(
+            mdls.ServiceAccount,
+            self.patch(
+                path=f"/users/service_accounts/{user_id}",
+                structure=mdls.ServiceAccount,
+                query_params={"fields": fields},
+                body=body,
+                transport_options=transport_options,
+            ),
+        )
+        return response
+
     # endregion
 
     # region UserAttribute: Manage User Attributes