メソッド: projects.transferConfigs.create

新しいデータ転送の構成を作成します。

HTTP リクエスト

POST https://bigquerydatatransfer.googleapis.com/v1/{parent=projects/*}/transferConfigs

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

転送構成が作成される BigQuery プロジェクト ID。projects/{projectId}/locations/{locationId} の形式にする必要があります。指定されたロケーションと宛先 bigquery データセットのロケーションが一致しない場合は、リクエストが失敗します。

認証には、指定されたリソース parent に対する次の Google IAM 権限が必要です。

  • bigquery.transfers.update

クエリ パラメータ

パラメータ
authorizationCode

string

（省略可）この転送構成で使用される OAuth2 認証コード。dataSources.checkValidCreds で指定されているように、新しい認証情報が必要な場合は必須です。authorizationCode を取得するには、https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri= に対してリクエストを発行します。

  • clientId は、dataSources.list メソッドから返される特定のデータソースの BigQuery DTS API の OAuth clientId である必要があります。
  • data_source_scopes は、dataSources.list メソッドから返されるスコープです。
  • redirect_uri は、オプション パラメータです。指定されなかった場合は、認証コードが認証フロー ウィンドウのオープナーに送信されます。そうでない場合は、リダイレクト URI に送信されます。urn:ietf:wg:oauth:2.0:oob の特殊な値は、ユーザーにコードをコピーしてアプリケーションに貼り付けるように要求するページテキストとともに、承認コードがブラウザのタイトルバーに返されることを意味します。

リクエストの本文

リクエストの本文には TransferConfig のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された TransferConfig のインスタンスが含まれます。

認証スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。

試してみる