Google Apps Meet API Client Library

0.4.0 · active · verified Fri Apr 17

The `google-apps-meet` library provides a Python client for interacting with the Google Meet API, enabling programmatic creation and management of Meet spaces. It is part of the larger `google-cloud-python` monorepo, currently at version 0.4.0, and receives frequent updates alongside other Google Cloud client libraries.

Common errors

```
ImportError: cannot import name 'SpacesServiceClient' from 'google.apps.meet'
```
cause Attempting to import the client from an incorrect or non-existent package path.

fix The correct import path for the client is `from google.apps.meet_v2beta import SpacesServiceClient`.
```
google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials.
```
cause The client library could not find valid Google Cloud credentials in the environment or could not infer them.

fix Set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to your service account key file path or authenticate using `gcloud auth application-default login`.
```
403 Permission denied: The caller does not have permission
```
cause The authenticated principal (service account or user) lacks the necessary IAM permissions to perform the requested Meet API operation.

fix Grant the required roles to your service account or user. For creating spaces, roles like 'Google Meet Admin SDK' or 'Owner' might be needed on the relevant project, or specific delegated permissions.

Warnings

gotcha Authentication is mandatory for all Google Meet API calls. The client library defaults to using Application Default Credentials (ADC).
Fix: Ensure `GOOGLE_APPLICATION_CREDENTIALS` environment variable points to a service account key file, or run `gcloud auth application-default login` for user credentials. Verify the service account or user has the necessary 'Google Meet' API roles (e.g., Google Meet Admin SDK role) on the relevant project/resource.
gotcha The primary client for Google Meet is currently `SpacesServiceClient` found under the `v2beta` API version. Other versions or a generic `MeetServiceClient` may not exist or function as expected.
Fix: Always import from `google.apps.meet_v2beta`, e.g., `from google.apps.meet_v2beta import SpacesServiceClient`.
gotcha When making API calls that require a resource name (e.g., retrieving a specific space), ensure the name is in the correct format (`spaces/SPACE_ID`).
Fix: Refer to the Google Meet API documentation for the exact resource name format. A space name will typically be formatted as 'spaces/AAAA-BBBB-CCCC'.

Install

pip install google-apps-meet Install stable version

Imports

SpacesServiceClient
wrong:
```
from google.apps.meet import MeetServiceClient
```
correct:
```
from google.apps.meet_v2beta import SpacesServiceClient
```
The Meet API is currently exposed via the 'v2beta' client for Spaces, not a generic 'meet' or 'v1' client.
Space
```
from google.apps.meet_v2beta.types import Space
```
Type hints and client methods often require importing specific type definitions from the 'types' submodule.

Quickstart

This quickstart demonstrates how to initialize the `SpacesServiceClient` and create a new Google Meet space using default settings. Ensure your environment is authenticated with Google Cloud credentials before running.

import os
from google.apps.meet_v2beta import SpacesServiceClient
from google.apps.meet_v2beta.types import Space

# --- Authentication Setup ---
# The client library automatically looks for credentials in the following order:
# 1. The GOOGLE_APPLICATION_CREDENTIALS environment variable.
# 2. Credentials from `gcloud auth application-default login`.
# 3. Credentials from the Google Cloud SDK (e.g., from `gcloud auth login`).
# For local development, set GOOGLE_APPLICATION_CREDENTIALS or use `gcloud auth application-default login`.
# Example: export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/keyfile.json"

# Initialize the client
client = SpacesServiceClient()

# Create a new Google Meet space
# An empty Space object is often sufficient for creation, letting the API fill in defaults.
# For advanced configuration, populate the Space object with a SpaceConfig.
new_space = Space()

try:
    created_space = client.create_space(space=new_space)

    print(f"Successfully created Meet Space.")
    print(f"Space Name: {created_space.name}")
    print(f"Meeting URI: {created_space.meeting_uri}")

except Exception as e:
    print(f"An error occurred: {e}")
    if "credentials" in str(e) or "Permission denied" in str(e):
        print("Hint: Check your authentication setup and IAM permissions (e.g., 'Google Meet Admin SDK' role).")

view raw JSON →