[AIRFLOW-XXXX] Fix reference to GCP classes in guides (#7762)

Author: mik-laj

airflow/providers/google/cloud/example_dags/example_gcs_to_bq.py

@@ -16,7 +16,7 @@
 # specific language governing permissions and limitations
 # under the License.
 """
-Example DAG using GoogleCloudStorageToBigQueryOperator.
+Example DAG using GCSToBigQueryOperator.
 """
 from airflow import models
 from airflow.operators.bash import BashOperator

airflow/providers/google/cloud/operators/cloud_sql.py

@@ -213,7 +213,7 @@ class CloudSQLCreateInstanceOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceCreateOperator`
+        :ref:`howto/operator:CloudSQLCreateInstanceOperator`
 
     :param body: Body required by the Cloud SQL insert API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert
@@ -297,7 +297,7 @@ class CloudSQLInstancePatchOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstancePatchOperator`
+        :ref:`howto/operator:CloudSQLInstancePatchOperator`
 
     :param body: Body required by the Cloud SQL patch API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
@@ -356,7 +356,7 @@ class CloudSQLDeleteInstanceOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceDeleteOperator`
+        :ref:`howto/operator:CloudSQLDeleteInstanceOperator`
 
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
@@ -404,7 +404,7 @@ class CloudSQLCreateInstanceDatabaseOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceDatabaseCreateOperator`
+        :ref:`howto/operator:CloudSQLCreateInstanceDatabaseOperator`
 
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
@@ -481,7 +481,7 @@ class CloudSQLPatchInstanceDatabaseOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceDatabasePatchOperator`
+        :ref:`howto/operator:CloudSQLPatchInstanceDatabaseOperator`
 
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
@@ -558,7 +558,7 @@ class CloudSQLDeleteInstanceDatabaseOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceDatabaseDeleteOperator`
+        :ref:`howto/operator:CloudSQLDeleteInstanceDatabaseOperator`
 
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
@@ -622,7 +622,7 @@ class CloudSQLExportInstanceOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceImportOperator`
+        :ref:`howto/operator:CloudSQLExportInstanceOperator`
 
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
@@ -702,7 +702,7 @@ class CloudSQLImportInstanceOperator(CloudSQLBaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlInstanceImportOperator`
+        :ref:`howto/operator:CloudSQLImportInstanceOperator`
 
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
@@ -767,7 +767,7 @@ class CloudSQLExecuteQueryOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudSqlQueryOperator`
+        :ref:`howto/operator:CloudSQLExecuteQueryOperator`
 
     :param sql: SQL query or list of queries to run (should be DML or DDL query -
         this operator does not return any data from the database,

airflow/providers/google/cloud/operators/gcs.py

@@ -401,7 +401,7 @@ class GCSBucketCreateAclEntryOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:GoogleCloudStorageBucketCreateAclEntryOperator`
+        :ref:`howto/operator:GCSBucketCreateAclEntryOperator`
 
     :param bucket: Name of a bucket.
     :type bucket: str
@@ -465,7 +465,7 @@ class GCSObjectCreateAclEntryOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator`
+        :ref:`howto/operator:GCSObjectCreateAclEntryOperator`
 
     :param bucket: Name of a bucket.
     :type bucket: str

airflow/providers/google/cloud/operators/gcs_to_bigquery.py

@@ -40,7 +40,7 @@ class GCSToBigQueryOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:GoogleCloudStorageToBigQueryOperator`
+        :ref:`howto/operator:GCSToBigQueryOperator`
 
     :param bucket: The bucket to load from. (templated)
     :type bucket: str

airflow/providers/google/cloud/operators/text_to_speech.py

@@ -38,7 +38,7 @@ class CloudTextToSpeechSynthesizeOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:GcpTextToSpeechSynthesizeOperator`
+        :ref:`howto/operator:CloudTextToSpeechSynthesizeOperator`
 
     :param input_data: text input to be synthesized. See more:
         https://googleapis.github.io/google-cloud-python/latest/texttospeech/gapic/v1/types.html#google.cloud.texttospeech_v1.types.SynthesisInput

airflow/providers/google/cloud/operators/vision.py

@@ -41,7 +41,7 @@ class CloudVisionCreateProductSetOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductSetCreateOperator`
+        :ref:`howto/operator:CloudVisionCreateProductSetOperator`
 
     :param product_set: (Required) The ProductSet to create. If a dict is provided, it must be of the same
         form as the protobuf message `ProductSet`.
@@ -123,7 +123,7 @@ class CloudVisionGetProductSetOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductSetGetOperator`
+        :ref:`howto/operator:CloudVisionGetProductSetOperator`
 
     :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
         are: us-east1, us-west1, europe-west1, asia-east1
@@ -200,7 +200,7 @@ class CloudVisionUpdateProductSetOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductSetUpdateOperator`
+        :ref:`howto/operator:CloudVisionUpdateProductSetOperator`
 
     :param product_set: (Required) The ProductSet resource which replaces the one on the
         server. If a dict is provided, it must be of the same form as the protobuf
@@ -282,7 +282,7 @@ class CloudVisionDeleteProductSetOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductSetDeleteOperator`
+        :ref:`howto/operator:CloudVisionDeleteProductSetOperator`
 
     :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
         are: us-east1, us-west1, europe-west1, asia-east1
@@ -354,7 +354,7 @@ class CloudVisionCreateProductOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductCreateOperator`
+        :ref:`howto/operator:CloudVisionCreateProductOperator`
 
     :param location: (Required) The region where the Product should be created. Valid regions
         (as of 2019-02-05) are: us-east1, us-west1, europe-west1, asia-east1
@@ -439,7 +439,7 @@ class CloudVisionGetProductOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductGetOperator`
+        :ref:`howto/operator:CloudVisionGetProductOperator`
 
     :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
         us-east1, us-west1, europe-west1, asia-east1
@@ -527,7 +527,7 @@ class CloudVisionUpdateProductOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductUpdateOperator`
+        :ref:`howto/operator:CloudVisionUpdateProductOperator`
 
     :param product: (Required) The Product resource which replaces the one on the server. product.name is
         immutable. If a dict is provided, it must be of the same form as the protobuf message `Product`.
@@ -614,7 +614,7 @@ class CloudVisionDeleteProductOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionProductDeleteOperator`
+        :ref:`howto/operator:CloudVisionDeleteProductOperator`
 
     :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
         us-east1, us-west1, europe-west1, asia-east1
@@ -680,7 +680,7 @@ class CloudVisionImageAnnotateOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionAnnotateImageOperator`
+        :ref:`howto/operator:CloudVisionImageAnnotateOperator`
 
     :param request: (Required) Annotation request for image or a batch.
         If a dict is provided, it must be of the same form as the protobuf
@@ -738,7 +738,7 @@ class CloudVisionCreateReferenceImageOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionReferenceImageCreateOperator`
+        :ref:`howto/operator:CloudVisionCreateReferenceImageOperator`
 
     :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
         us-east1, us-west1, europe-west1, asia-east1
@@ -1051,7 +1051,7 @@ class CloudVisionTextDetectOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:CloudVisionDetectDocumentTextOperator`
+        :ref:`howto/operator:CloudVisionTextDetectOperator`
 
     :param image: (Required) The image to analyze. See more:
         https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/types.html#google.cloud.vision_v1.types.Image

docs/howto/define_extra_link.rst

@@ -81,7 +81,7 @@ tasks using :class:`~airflow.providers.amazon.aws.operators.gcs_to_s3.GCSToS3Ope
       name = 'S3'
 
       # Add list of all the operators to which you want to add this OperatorLinks
-      # Example: operators = [GCSToS3Operator, GoogleCloudStorageToBigQueryOperator]
+      # Example: operators = [GCSToS3Operator, GCSToBigQueryOperator]
       operators = [GCSToS3Operator]
 
       def get_link(self, operator, dttm):

docs/howto/operator/gcp/bigquery_dts.rst

@@ -44,12 +44,12 @@ Creating transfer configuration
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To create DTS transfer configuration you can use
-:class:`airflow.providers.google.cloud.operators.bigquery_dts.BigQueryCreateDataTransferOperator`.
+:class:`~airflow.providers.google.cloud.operators.bigquery_dts.BigQueryCreateDataTransferOperator`.
 
 In the case of Airflow, the customer needs to create a transfer config with the automatic scheduling disabled
 and then trigger a transfer run using a specialized Airflow operator that will call StartManualTransferRuns API
-for example :class:`airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDataTransferServiceStartTransferRunsOperator`.
-:class:`airflow.providers.google.cloud.operators.bigquery_dts.BigQueryCreateDataTransferOperator` checks if automatic
+for example :class:`~airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDataTransferServiceStartTransferRunsOperator`.
+:class:`~airflow.providers.google.cloud.operators.bigquery_dts.BigQueryCreateDataTransferOperator` checks if automatic
 scheduling option is present in passed configuration. If present then nothing is done, otherwise it's value is
 set to ``True``.
 
@@ -80,7 +80,7 @@ Deleting transfer configuration
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To delete DTS transfer configuration you can use
-:class:`airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDeleteDataTransferConfigOperator`.
+:class:`~airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDeleteDataTransferConfigOperator`.
 
 Basic usage of the operator:
 
@@ -101,7 +101,7 @@ Manually starting transfer runs
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Start manual transfer runs to be executed now with schedule_time equal to current time.
-:class:`airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDataTransferServiceStartTransferRunsOperator`.
+:class:`~airflow.providers.google.cloud.operators.bigquery_dts.BigQueryDataTransferServiceStartTransferRunsOperator`.
 
 Basic usage of the operator:
 
@@ -116,7 +116,7 @@ You can use :ref:`Jinja templating <jinja-templating>` with
 parameters which allows you to dynamically determine values.
 
 To check if operation succeeded you can use
-:class:`airflow.providers.google.cloud.sensors.bigquery_dts.BigQueryDataTransferServiceTransferRunSensor`.
+:class:`~airflow.providers.google.cloud.sensors.bigquery_dts.BigQueryDataTransferServiceTransferRunSensor`.
 
 .. exampleinclude:: ../../../../airflow/providers/google/cloud/example_dags/example_bigquery_dts.py
     :language: python

docs/howto/operator/gcp/cloud_memorystore.rst

@@ -57,10 +57,10 @@ Configuration of bucket permissions for import / export
 
 It is necessary to configure permissions for the bucket to import and export data. Too find the service
 account for your instance, run the :class:`~airflow.providers.google.cloud.operators.cloud_memorystore.CloudMemorystoreCreateInstanceOperator` or
-:class:`~airflow.providers.google.cloud.operators.cloud_memorystore.CloudMemorystoreGetInstancesOperator` and
+:class:`~airflow.providers.google.cloud.operators.cloud_memorystore.CloudMemorystoreGetInstanceOperator` and
 make a use of the service account listed under ``persistenceIamIdentity``.
 
-You can use :class:`airflow.contrib.operators.gcs.GoogleCloudStorageBucketCreateAclEntryOperator`
+You can use :class:`~airflow.providers.google.cloud.operators.gcs.GCSBucketCreateAclEntryOperator`
 operator to set permissions.
 
 .. exampleinclude:: ../../../../airflow/providers/google/cloud/example_dags/example_cloud_memorystore.py