Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
544 changes: 540 additions & 4 deletions .librarian/config.yaml

Large diffs are not rendered by default.

819 changes: 819 additions & 0 deletions .librarian/state.yaml

Large diffs are not rendered by default.

4,621 changes: 4,614 additions & 7 deletions librarian.yaml

Large diffs are not rendered by default.

19 changes: 8 additions & 11 deletions packages/bigquery-magics/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,13 @@
{
"name": "bigquery-magics",
"name_pretty": "Google BigQuery connector for Jupyter and IPython",
"product_documentation": "https://cloud.google.com/bigquery",
"api_id": "bigquery.googleapis.com",
"client_documentation": "https://googleapis.dev/python/bigquery-magics/latest/",
"distribution_name": "bigquery-magics",
"issue_tracker": "https://github.com/googleapis/python-bigquery-magics/issues",
"release_level": "stable",
"language": "python",
"library_type": "INTEGRATION",
"repo": "googleapis/google-cloud-python",
"distribution_name": "bigquery-magics",
"api_id": "bigquery.googleapis.com",
"requires_billing": false,
"default_version": "",
"codeowner_team": "@googleapis/cloud-sdk-python-team @googleapis/bigquery-dataframe-team"
}
"name": "bigquery-magics",
"name_pretty": "Google BigQuery connector for Jupyter and IPython",
"product_documentation": "https://cloud.google.com/bigquery",
"release_level": "preview",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The release_level has been changed from stable to preview. Downgrading the release status of a library is unusual and might be an accidental change during migration, especially since the corresponding README.rst still references General Availability (GA) support.

Suggested change
"release_level": "preview",
"release_level": "stable",

"repo": "googleapis/google-cloud-python"
}
1 change: 0 additions & 1 deletion packages/bigquery-magics/docs/README.rst

This file was deleted.

103 changes: 103 additions & 0 deletions packages/bigquery-magics/docs/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
IPython Magics for BigQuery
===========================

|GA| |pypi| |versions|

Querying massive datasets can be time consuming and expensive without the
right hardware and infrastructure. Google `BigQuery`_ solves this problem by
enabling super-fast, SQL queries against append-mostly tables, using the
processing power of Google's infrastructure.

- `Library Documentation`_
- `Product Documentation`_

.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
.. |pypi| image:: https://img.shields.io/pypi/v/bigquery-magics.svg
:target: https://pypi.org/project/bigquery-magics/
.. |versions| image:: https://img.shields.io/pypi/pyversions/bigquery-magics.svg
:target: https://pypi.org/project/bigquery-magics/
.. _BigQuery: https://cloud.google.com/bigquery/what-is-bigquery
.. _Library Documentation: https://googleapis.dev/python/bigquery-magics/latest
.. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/

Quick Start
-----------

In order to use this library, you first need to go through the following steps:

1. `Select or create a Cloud Platform project.`_
2. `Enable billing for your project.`_
3. `Enable the Google Cloud BigQuery API.`_
4. `Setup Authentication.`_

.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
.. _Enable the Google Cloud BigQuery API.: https://cloud.google.com/bigquery
.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html

Installation
~~~~~~~~~~~~

Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.

With `virtualenv`_, it's possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies.

.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/


Supported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^
Python >= 3.9

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8.


Mac/Linux
^^^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install bigquery-magics


Windows
^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install bigquery-magics

Example Usage
-------------

To use these magics, you must first register them. Run the ``%load_ext bigquery_magics``
in a Jupyter notebook cell.

.. code-block::

%load_ext bigquery_magics

Perform a query
~~~~~~~~~~~~~~~

.. code:: python

%%bigquery
SELECT name, SUM(number) as count
FROM 'bigquery-public-data.usa_names.usa_1910_current'
GROUP BY name
ORDER BY count DESC
LIMIT 3
17 changes: 7 additions & 10 deletions packages/db-dtypes/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,15 +1,12 @@
{
"api_id": "bigquery.googleapis.com",
"client_documentation": "https://googleapis.dev/python/db-dtypes/latest/index.html",
"distribution_name": "db-dtypes",
"language": "python",
"library_type": "INTEGRATION",
"name": "db-dtypes",
"name_pretty": "Pandas Data Types for SQL systems (BigQuery, Spanner)",
"product_documentation": "https://pandas.pydata.org/pandas-docs/stable/ecosystem.html#ecosystem-extensions",
"client_documentation": "https://googleapis.dev/python/db-dtypes/latest/index.html",
"release_level": "stable",
"language": "python",
"library_type": "INTEGRATION",
"repo": "googleapis/google-cloud-python",
"distribution_name": "db-dtypes",
"api_id": "bigquery.googleapis.com",
"default_version": "",
"codeowner_team": "@googleapis/python-core-client-libraries",
"api_description": "Pandas extension data types for data from SQL systems such as BigQuery."
}
"repo": "googleapis/google-cloud-python"
}
1 change: 0 additions & 1 deletion packages/db-dtypes/docs/README.rst

This file was deleted.

63 changes: 63 additions & 0 deletions packages/db-dtypes/docs/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
Pandas Data Types for SQL systems (BigQuery, Spanner)
=====================================================

|ga| |pypi| |versions|

`Pandas extension data types`_ for data from SQL systems such as `BigQuery`_.

- `Library Documentation`_

.. |ga| image:: https://img.shields.io/badge/support-GA-gold.svg
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
.. |pypi| image:: https://img.shields.io/pypi/v/db-dtypes.svg
:target: https://pypi.org/project/db-dtypes/
.. |versions| image:: https://img.shields.io/pypi/pyversions/db-dtypes.svg
:target: https://pypi.org/project/db-dtypes/
.. _Pandas extension data types: https://pandas.pydata.org/docs/development/extending.html#extension-types
.. _BigQuery: https://cloud.google.com/bigquery/docs/
.. _Library Documentation: https://googleapis.dev/python/db-dtypes/latest


Installation
------------

Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.

With `virtualenv`_, it's possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies.

.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/


Supported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^
Python >= 3.9

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8.


Mac/Linux
^^^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install db-dtypes


Windows
^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install db-dtypes
15 changes: 6 additions & 9 deletions packages/gapic-generator/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,11 @@
{
"name": "gapic-generator",
"name_pretty": "Google API Client Generator for Python",
"client_documentation": "https://gapic-generator-python.readthedocs.io/en/stable/",
"product_documentation": "",
"distribution_name": "gapic-generator",
"issue_tracker": "https://github.com/googleapis/google-cloud-python/issues",
"release_level": "stable",
"language": "python",
"library_type": "CORE",
"repo": "googleapis/google-cloud-python",
"distribution_name": "gapic-generator",
"default_version": "",
"codeowner_team": "@googleapis/cloud-sdk-python-team"
}
"name": "gapic-generator",
"name_pretty": "Google API Client Generator for Python",
"release_level": "stable",
"repo": "googleapis/google-cloud-python"
}
23 changes: 11 additions & 12 deletions packages/gcp-sphinx-docfx-yaml/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
{
"name": "gcp-sphinx-docfx-yaml",
"name_pretty": "Sphinx DocFX YAML Generator",
"product_documentation": "https://github.com/googleapis/sphinx-docfx-yaml",
"client_documentation": "https://github.com/googleapis/sphinx-docfx-yaml",
"issue_tracker": "https://github.com/googleapis/sphinx-docfx-yaml/issues",
"release_level": "preview",
"language": "python",
"repo": "googleapis/google-cloud-python",
"distribution_name": "gcp-sphinx-docfx-yaml",
"codeowner_team": "@googleapis/dkp-team",
"library_type": "OTHER"
}
"client_documentation": "https://github.com/googleapis/sphinx-docfx-yaml",
"distribution_name": "gcp-sphinx-docfx-yaml",
"issue_tracker": "https://github.com/googleapis/sphinx-docfx-yaml/issues",
"language": "python",
"library_type": "OTHER",
"name": "gcp-sphinx-docfx-yaml",
"name_pretty": "Sphinx DocFX YAML Generator",
"product_documentation": "https://github.com/googleapis/sphinx-docfx-yaml",
"release_level": "stable",
"repo": "googleapis/google-cloud-python"
}
28 changes: 14 additions & 14 deletions packages/google-ads-admanager/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
{
"api_description": "Manage your Ad Manager inventory, run reports and more.",
"api_id": "admanager.googleapis.com",
"api_shortname": "admanager",
"client_documentation": "https://googleapis.dev/python/google-ads-admanager/latest",
"default_version": "v1",
"distribution_name": "google-ads-admanager",
"issue_tracker": "https://issuetracker.google.com/issues/new?component=1265187&template=1787490",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-admanager",
"name_pretty": "Google Ad Manager",
"product_documentation": "https://developers.google.com/ad-manager/api/beta",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
"api_description": "Manage your Ad Manager inventory, run reports and more.",
"api_id": "admanager.googleapis.com",
"api_shortname": "admanager",
"client_documentation": "https://googleapis.dev/python/google-ads-admanager/latest",
"default_version": "v1",
"distribution_name": "google-ads-admanager",
"issue_tracker": "https://issuetracker.google.com/issues/new?component=1265187\u0026template=1787490",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-admanager",
"name_pretty": "Google Ad Manager",
"product_documentation": "https://developers.google.com/ad-manager/api/beta",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
}
30 changes: 15 additions & 15 deletions packages/google-ads-datamanager/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
{
"api_description": "A unified ingestion API for data partners, agencies and advertisers to\nconnect first-party data across Google advertising products.",
"api_id": "datamanager.googleapis.com",
"api_shortname": "datamanager",
"client_documentation": "https://cloud.google.com/python/docs/reference/google-ads-datamanager/latest",
"default_version": "v1",
"distribution_name": "google-ads-datamanager",
"issue_tracker": "https://issuetracker.google.com/issues/new?component=1812065",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-datamanager",
"name_pretty": "Data Manager API",
"product_documentation": "https://developers.google.com/data-manager",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
}
"api_description": "A unified ingestion API for data partners, agencies and advertisers to\nconnect first-party data across Google advertising products.",
"api_id": "datamanager.googleapis.com",
"api_shortname": "datamanager",
"client_documentation": "https://cloud.google.com/python/docs/reference/google-ads-datamanager/latest",
"default_version": "v1",
"distribution_name": "google-ads-datamanager",
"issue_tracker": "https://issuetracker.google.com/issues/new?component=1812065",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-datamanager",
"name_pretty": "Data Manager API",
"product_documentation": "https://developers.google.com/data-manager",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
}
28 changes: 14 additions & 14 deletions packages/google-ads-marketingplatform-admin/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
{
"api_description": "The Google Marketing Platform Admin API allows for programmatic access to the Google Marketing Platform configuration data. You can use the Google Marketing Platform Admin API to manage links between your Google Marketing Platform organization and Google Analytics accounts, and to set the service level of your GA4 properties.",
"api_id": "marketingplatformadmin.googleapis.com",
"api_shortname": "marketingplatformadmin",
"client_documentation": "https://googleapis.dev/python/google-ads-marketingplatform-admin/latest",
"default_version": "v1alpha",
"distribution_name": "google-ads-marketingplatform-admin",
"issue_tracker": "https://github.com/googleapis/google-cloud-python/issues",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-marketingplatform-admin",
"name_pretty": "Google Marketing Platform Admin API",
"product_documentation": "https://developers.google.com/analytics/devguides/config/gmp/v1",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
"api_description": "The Google Marketing Platform Admin API allows for programmatic access to the Google Marketing Platform configuration data. You can use the Google Marketing Platform Admin API to manage links between your Google Marketing Platform organization and Google Analytics accounts, and to set the service level of your GA4 properties.",
"api_id": "marketingplatformadmin.googleapis.com",
"api_shortname": "marketingplatformadmin",
"client_documentation": "https://googleapis.dev/python/google-ads-marketingplatform-admin/latest",
"default_version": "v1alpha",
"distribution_name": "google-ads-marketingplatform-admin",
"issue_tracker": "https://github.com/googleapis/google-cloud-python/issues",
"language": "python",
"library_type": "GAPIC_AUTO",
"name": "google-ads-marketingplatform-admin",
"name_pretty": "Google Marketing Platform Admin API",
"product_documentation": "https://developers.google.com/analytics/devguides/config/gmp/v1",
"release_level": "preview",
"repo": "googleapis/google-cloud-python"
}
Loading
Loading