SharePoint

SharePoint コネクタは、SharePoint サービスとサーバーに SQL アクセスを提供します。

サポート対象のバージョン

このコネクタは、Windows SharePoint Services 3.0、Microsoft Office SharePoint Server 2007 以降、SharePoint Online をサポートしています。

始める前に

SharePoint コネクタを使用する前に、次の作業を行います。

  • Google Cloud プロジェクトで次の操作を行います。
    • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
    • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
    • コネクタに使用するサービス アカウントに、次の IAM ロールを付与します。
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      サービス アカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービス アカウントがない場合は、サービス アカウントを作成する必要があります。詳細については、サービス アカウントを作成するをご覧ください。

    • 次のサービスを有効にします。
      • secretmanager.googleapis.com(Secret Manager API)
      • connectors.googleapis.com(Connectors API)

      サービスを有効にする方法については、サービスを有効にするをご覧ください。

    以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

コネクタを構成する

コネクタを構成するには、データソース(バックエンド システム)への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

  1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

    [接続] ページに移動

  2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
  3. [ロケーション] セクションで、接続のロケーションを選択します。
    1. リージョン: プルダウン リストからロケーションを選択します

      コネクタをサポートしているリージョンは次のとおりです。

      サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。

    2. [次へ] をクリックします。
  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタ: 使用可能なコネクタのプルダウン リストから [SharePoint] を選択します。
    2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 49 文字以内で指定してください。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
    6. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
    7. 必要に応じて、接続ノードの設定を構成します。

      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位(またはレプリカ)です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され(可用性を高めるため)、最大ノード数は 50 に設定されます。

    8. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    9. [次へ] をクリックします。
  5. [宛先] セクションに、接続するリモートホスト(バックエンド システム)の詳細を入力します。
    1. 宛先の種類: 宛先の種類を選択します。たとえば、ホストアドレスは https://xxxxx.sharepoint.com です。
      • リストから [ホストアドレス] を選択し、宛先のホスト名または IP アドレスを指定します。
      • バックエンド システムへのプライベート接続を確立する場合は、リストからエンドポイント アタッチメントを選択し、次にエンドポイント アタッチメントリストから必要なエンドポイント アタッチメントを選択します。

      セキュリティをさらに強化してバックエンドシステムへのパブリック接続を確立する場合は、接続用の静的アウトバウンド IP アドレスの構成を検討してから、特定の静的 IP アドレスのみを許可リストに登録するようファイアウォール ルールを構成します。

      他の宛先を入力するには、[+ 宛先を追加] をクリックします。

    2. [次へ] をクリックします。
  6. [認証] セクションで、認証の詳細を入力します。
    1. [認証タイプ] を選択し、関連する詳細を入力します。

      SharePoint 接続でサポートされる認証タイプは次のとおりです。

      • Windows 認証情報。SharePoint のオンプレミス エディションを使用する場合は、このオプションを選択します。
      • AzureAD。SharePoint のオンライン エディションを使用する場合は、このオプションを選択します。
      • JWT Bearer を使用した OAuth 2.0 クライアント認証情報。認証に JWT Bearer OAuth 2.0 クライアント認証情報を使用する場合は、このオプションを選択します。
      • クライアント シークレットを使用する OAuth 2.0 クライアント認証情報。認証にクライアント シークレットを使用する OAuth 2.0 クライアント認証情報を使用する場合は、このオプションを選択します。
    2. これらの認証タイプの構成方法については、認証を構成するをご覧ください。

    3. [次へ] をクリックします。
  7. Review: 接続と認証の詳細を確認します。
  8. [作成] をクリックします。

認証を構成する

SharePoint コネクタは、次の認証タイプをサポートしています。

Windows 認証情報の認証タイプ

Windows 認証情報の認証タイプを有効にするには、次の手順を完了する必要があります。
  1. PSC を構成し、エンドポイント アタッチメントを作成します。
  2. Google Cloud で認証情報を指定する

PSC を構成してエンドポイント アタッチメントを作成する

  1. SharePoint がホストされている IP を使用してインスタンス グループを作成します。
  2. 内部パススルー ネットワーク ロードバランサを作成し、作成したインスタンス グループをバックエンドとして使用します。TCP 内部ロードバランサでグローバル アクセスを有効にする必要があります。
  3. Private Service Connect でロードバランサを公開します。サービス アタッチメントは、ロードバランサが公開された後に生成されます。
  4. サービスを公開し、作成したロードバランサを指定します。
  5. サービス アタッチメントを使用して、エンドポイント アタッチメントを作成します。
  6. エンドポイント アタッチメントを作成したら、エンドポイント アタッチメントの IP を使用して SharePoint 接続を作成します。
  7. エンドポイント アタッチメントの作成の詳細については、エンドポイント アタッチメントを作成するをご覧ください。

Google Cloud で Windows 認証情報の詳細を指定する

Integration Connectors で接続を作成する場合は、次の詳細を指定する必要があります。

[Authentication] セクションで、認証タイプとして [Windows credentials] を選択し、次の詳細を入力します。

  • ユーザー名: ユーザー名を入力します。
  • パスワード: パスワードを選択します。
  • シークレット バージョン: シークレット バージョンを入力します。

Windows 認証情報の接続タイプ

次の表に、Windows 認証情報の接続タイプのサンプル構成値を示します。
フィールド名 詳細
リージョン us-central1
コネクタ SharePoint
コネクタのバージョン 1
接続名 sharepoint-staging-psc
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ノードの最小数 2
ノードの最大数 50
宛先の種類 ホストアドレス
host 1 http://192.0.2.0
port 1 24
Authentication Windows 認証情報
ユーザー名 USER_NAME
パスワード PASSWORD
シークレット バージョン 1

Azure AD 認証の種類

Azure AD 認証タイプを有効にするには、次の手順を完了する必要があります。
  1. アプリを登録して OAuthClientId と OAuthClientSecret を取得する
  2. Google Cloud で認証情報を指定する
  3. Google Cloud で接続を承認します
  4. リダイレクト URL をアプリに追加します

アプリを登録して OAuthClientId と OAuthClientSecret を取得する

アプリを登録して、アプリの OAuthClientId と OAuthClientSecret を取得するには、次の操作を行います。
  1. Azure Portal にログインします。
  2. [Azure サービス] で、[アプリの登録]、[新しい登録] の順に選択します。
  3. アプリケーション名を入力し、[Any Microsoft Entra ID tenant - Multitenant] を選択します。次の画像は、[アプリを登録する] ページを示しています。
  4. アプリを作成したら、[Certificates & Secrets] セクションに移動し、アプリケーションのクライアント シークレットを作成して、クライアント シークレットの値を保存します。次の図は、[証明書とシークレット] ページを示しています。
  5. [API 権限] で、必要なアプリケーション権限と委任された権限を選択します。接続を有効にするには、次の最小権限を付与する必要があります。AllSites.Manage

    次の表に、アプリケーションでオペレーションを実行するために必要な権限を示します。

    委任された権限 アプリの権限
    ConsentRequest.Read.All AllSites.FullControl
    ConsentRequest.ReadWrite.All AllSites.Manage
    DelegatedAdminRelationship.Read.All AllSites.Read
    DelegatedAdminRelationship.ReadWrite.All AllSites.Write
    DelegatedPermissionGrant.Read.All EnterpriseResource.Read
    DelegatedPermissionGrant.ReadWrite.All EnterpriseResource.Write
    Files.Read.All MyFiles.Read
    Files.ReadWrite.All MyFiles.Write
    Group.Create Project.Read
    Group.Read.All Project.Write
    Group.ReadWrite.All ProjectWebApp.FullControl
    Sites.FullControl.All ProjectWebAppReporting.Read
    Sites.FullControl.All Sites.FullControl.All
    Sites.Manage.All Sites.Manage.All
    Sites.Read.All Sites.Read.All
    Sites.ReadWrite.All Sites.ReadWrite.All
    Sites.Selected Sites.Search.All
    User.Export.All Sites.Selected
    User.Read TaskStatus.Submit
    User.Read.All TermStore.Read.All
    User.ReadWrite.All TermStore.Read.All
    TermStore.ReadWrite.All
    TermStore.ReadWrite.All
    User.Read.All
    User.Read.All
    User.ReadWrite.All
    User.ReadWrite.All
  6. 変更を保存します。
  7. 管理者の同意が必要な権限を使用するように選択した場合は、現在のテナントの [API 権限] ページで権限を付与できます。次の図は、API 権限ページを示しています。
  8. スコープを追加するには、[API を公開する] セクションに移動し、AllSites.Manage, Sites.FullControl.All スコープを追加して、管理者とユーザーのどちらが制御できるかを選択します。次の図は、[API を公開する] ページを示しています。
  9. [保存] をクリックします。

Google Cloud で認証情報を指定する

Integration Connectors で接続を作成する場合は、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [AzureAD] を選択し、次の詳細を入力します。

  • クライアント ID: アクセス トークンのリクエストに使用するクライアント ID を入力します。
  • スコープ: 必要なスコープをカンマ区切りで入力します。例: Sites.FullControl.All
  • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret を入力します。
  • シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
  • 承認 URL: クライアントの作成時に生成された承認 URL。URL は https://login.microsoftonline.com/<tenant_identifier>/oauth2/v2.0/authorize の形式で入力します。例: https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize

Google Cloud で接続を承認する

  1. 接続ページで、新しく作成された接続を見つけます。

    新しいコネクタの [ステータス] は [承認が必要] になります。

  2. [承認が必要] をクリックします。

    これにより、[承認の編集] ペインが表示されます。

  3. [リダイレクト URI] の値を外部アプリケーションにコピーします。詳しくは、アプリにリダイレクト URL を追加するをご覧ください。
  4. 認可の詳細を確認します。
  5. [Authorize(承認)] をクリックします。

    認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

リダイレクト URL をアプリに追加する

  1. Azure ポータルで、[Azure サービス] > [アプリの登録] をクリックします。
  2. アプリ名をクリックします。
  3. [リダイレクト URI を追加] をクリックします。
  4. [Add a platform] をクリックします。
  5. [Web] ダイアログで、Google Cloud で接続を承認したときにコピーしたリダイレクト URI を貼り付けます。

Azure AD 接続の種類

次の表に、Azure AD 接続タイプのサンプル構成値を示します。
フィールド名 詳細
リージョン us-central1
コネクタ SharePoint
コネクタのバージョン 1
接続名 sharepoint-google-cloud-con
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ノードの最小数 2
ノードの最大数 50
宛先の種類 ホストアドレス
host 1 http://z8**.sharepoint.com
認証 AzureAD
クライアント ID CLIENT_ID
スコープ Sites.FullControl.All
クライアント シークレット CLIENT_SECRET
シークレット バージョン 1
認証 URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

OAuth 2.0 - JWT Bearer 認証タイプを使用したクライアント認証情報

OAuth 2.0 - JWT Bearer 認証タイプを使用したクライアント認証情報を有効にするには、次の手順を完了する必要があります。
  1. 証明書を作成します
  2. 証明書を Azure Portal にアップロードします
  3. 秘密鍵を取得する
  4. セットアップを完了します。
  5. Google Cloud で OAuth 2.0 JWT Bearer 認証情報を指定する

JWT ベアラ認証タイプを有効にするには、証明書を作成して Azure ポータルにアップロードし、秘密鍵を取得する必要があります。

証明書を生成

  1. パソコンに空のフォルダを作成します。
  2. フォルダにテキスト ファイルを作成します。
  3. Azure AD アプリのみによるアクセス権の付与ページ から PowerShell スクリプトをコピーし、テキスト ファイルに貼り付けます。
  4. テキスト ファイルの名前を Create-SelfSignedCertificate.ps1 に変更します。
  5. フォルダで Windows PowerShell を実行します。
  6. テキスト ファイルが含まれているディレクトリに移動します。
  7. 次のコマンドをコピーします。 .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

    CERTIFICATE_NAME の一意の名前を入力します。StartDate を現在の日付に、EndDate を任意の日付に変更します。

  8. 変更を加えたコマンドを Windows PowerShell に貼り付けて、Enter キーを押します。

    Windows PowerShell から、秘密鍵を保護するためのパスワードを入力するよう求められます。後で使用できるようにパスワードを保存してください。

    Windows PowerShell によって、MyCertificate.pfxMyCertificate.cer の 2 つのファイルが作成されます。

Azure Portal に証明書をアップロードする

  1. Azure Portal にログインし、次の詳細を指定して新しいアプリケーションを登録します。
    • 名前: アプリケーションの名前を入力します。
    • サポートされているアカウントの種類: [この組織ディレクトリ内のアカウントのみ(アカウント名のみ - 単一テナント)] を選択します。
  2. [API 権限] > [権限を追加] > [API 権限をリクエスト] > [SharePoint] に移動します。
  3. [アプリケーションのアクセス許可] を選択し、必要な権限を追加します。
  4. [管理者の同意を付与] を選択し、[はい] を選択します。
  5. アプリを作成したら、[Certificates & Secrets] セクションに移動します。
  6. [証明書をアップロード] を選択し、パソコンから CER 証明書をアップロードします。アップロードが完了したら、[追加] を選択します。

    アプリにクライアント シークレットを追加しないでください。証明書ベースの認証フローと競合する可能性があります。

  7. マニフェストに移動し、KeyCredentials を見つけて、customKeyIdentifier をサムプリントとしてコピーします。これは後で使用します。これで、アプリが登録され、証明書がリンクされました。

秘密鍵を取得する

秘密鍵を取得するには、OpenSSL を使用して PFX ファイルを PEM ファイルに変換します。

  1. コマンド プロンプトで、PFX ファイルのあるフォルダに移動し、次のコマンドを実行します。 openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
  2. 証明書の作成プロセスで使用した PFX パスワードを入力します。
  3. テキスト エディタで PEM ファイルを開き、秘密鍵の次のセクションをコピーします。
    -----BEGIN PRIVATE KEY----- 
    
    -----END PRIVATE KEY----- 
    

設定を完了する

  1. Azure ポータルで、新しく登録したアプリからクライアント ID とテナント ID をコピーします。
  2. 次の認証情報を使用して、SharePoint リスト サービス プリンシパル認証でログインします。
    • クライアント ID
    • テナント ID
    • 秘密鍵
    • 拇印(秘密鍵のパスワード)

Google Cloud で OAuth 2.0 JWT Bearer 認証情報を指定する

Integration Connectors で接続を作成する場合は、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [OAuth 2.0 クライアント認証情報(JWT ベアラーを使用)] を選択し、次の詳細を入力します。

  • クライアント ID: アクセス トークンのリクエストに使用するクライアント ID を入力します。これは、Azure Portal でアプリを登録したときに生成されたコンシューマ キーです。
  • 秘密鍵: PEM 形式の秘密鍵ファイルのコンテンツを含む Secret Manager の Secret を選択します。秘密鍵は、コネクタに提供された公開鍵/証明書と一致する必要があります。
  • シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
  • 秘密鍵パスワード: 秘密鍵ファイルのパスワード(言い回し)を含む Secret Manager の Secret を選択します。
  • シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
  • Azure テナント: データへのアクセスに使用されている Microsoft Online テナント。

JWT Bearer 証明書の接続タイプ

次の表に、OAuth 2.0 JWT Bearer 証明書接続タイプのサンプル構成値を示します。
フィールド名 詳細
リージョン europe-west1
コネクタ SharePoint
コネクタのバージョン 1
接続名 sharepoint-jwt-certificate
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ノードの最小数 2
ノードの最大数 50
宛先の種類 ホストアドレス
host 1 http://z8**.sharepoint.com
port 1 ****
Authentication OAuth 2.0 - JWT Bearer を使用したクライアント認証情報
OAuth クライアント ID CLIENT_ID
秘密鍵 キー
シークレット バージョン 1
秘密鍵のパスワード PASSWORD
シークレット バージョン 1
Azure テナント AZURE_TENANT_ID

OAuth 2.0 - クライアント シークレットの接続タイプ

OAuth 2.0 クライアント シークレット接続タイプを有効にするには、次の手順を完了する必要があります。

  1. アドインを登録する
  2. アドインに権限を付与する
  3. Google Cloud で OAuth 2.0 クライアント認証情報を指定する
  4. 認証コードの再認可

アドインを登録する

  1. 次の URL https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx を使用して、[アドオンを登録] ページに移動します。
  2. [アプリ情報] セクションで、クライアント ID とクライアント シークレットを生成します。
  3. [タイトル]、[アプリのドメイン]、[リダイレクト URI] の値を指定します。
  4. [作成] をクリックします。アドオンが登録され、SharePoint アプリに作成された情報が表示されます。

アドインに権限を付与する

  1. 次の URL を使用して SharePoint サイトに移動します。https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx[権限を付与] ページにリダイレクトされます。
  2. [アプリ ID] フィールドに、先ほど生成したクライアント ID を入力し、[参照] をクリックします。[タイトル]、[アプリのドメイン]、[リダイレクト URL] の値が入力されます。
  3. 次の権限リクエストを XML 形式で入力します。
    <AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/>
    </AppPermissionRequests>
      
  4. [作成] をクリックします。SharePoint アプリに権限の同意ダイアログが表示されます。
  5. [Trust It] をクリックします。

Google Cloud で OAuth 2.0 クライアント認証情報を指定する

Integration Connectors で接続を作成する場合は、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [OAuth 2.0 クライアント認証情報(クライアント シークレット付き)] を選択し、次の詳細を入力します。

  • クライアント ID: 作成したアプリに対してコネクタから提供されたクライアント ID を入力します。
  • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret Manager の Secret を選択します。
  • シークレットのバージョン: クライアント シークレットのバージョンを選択します。

認証コードの再認可

Authorization code 認証タイプを使用しているユーザーが、SharePoint アプリケーションの構成を変更した場合は、SharePoint 接続を再承認する必要があります。接続を再認可するには、次の手順を行います。

  1. [接続] ページで必要な接続をクリックします。

    これにより、[接続の詳細] ページが開きます。

  2. [編集] をクリックして、接続の詳細を編集します。
  3. [認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。

    必要に応じて必要な変更を加えます。

  4. [保存] をクリックします。接続の詳細ページに移動します。
  5. [認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
  6. [Authorize(承認)] をクリックします。

    認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

クライアント認証情報の接続タイプ

次の表に、OAuth 2.0 クライアント認証情報の接続タイプのサンプル構成値を示します。
フィールド名 詳細
リージョン europe-west1
コネクタ SharePoint
コネクタのバージョン 1
接続名 sharepoint-client-credentials
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ノードの最小数 2
ノードの最大数 50
宛先の種類 ホストアドレス
host 1 http://z8**.sharepoint.com
port 1 ****
認証 OAuth 2.0 - クライアント シークレットを使用するクライアント認証情報
クライアント ID CLIENT_ID
クライアント シークレット CLIENT_SECRET
シークレット バージョン 1

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

  • エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

    ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

  • オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。

    使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

  • アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

アクション

このセクションでは、コネクタでサポートされているアクションを一覧表示します。アクションの構成方法については、アクションの例をご覧ください。

DeleteAttachment アクション

このアクションにより、添付ファイルが削除されます。

DeleteAttachment アクションの入力パラメータ

パラメータ名 データ型 必須 説明
ListTitle 文字列 リストアイテムのタイトル。
ItemId 文字列 リストアイテムの ID。
FileName 文字列 ドキュメント ライブラリから削除するファイルの名前。

DeleteAttachment アクションの構成方法については、アクションの例をご覧ください。

CheckInDocument アクション

このアクションにより、ドキュメントをチェックインできます。

CheckInDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RelativeURL 文字列 フォルダの相対 URL。
DocumentName 文字列 チェックインするファイルの名前。
コメント 文字列 × チェックイン メッセージ(省略可)。

CheckInDocument アクションの構成方法については、アクションの例をご覧ください。

CheckOutDocument アクション

このアクションにより、ファイルをチェックアウトできます。

CheckOutDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RelativeURL 文字列 フォルダの相対 URL。
DocumentName 文字列 チェックアウトするファイルの名前。

CheckOutDocument アクションの構成方法については、アクションの例をご覧ください。

DiscardCheckOutDocument アクション

このアクションにより、ファイルのチェックアウトを元に戻すことができます。

DiscardCheckOutDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RelativeURL 文字列 フォルダの相対 URL。
DocumentName 文字列 チェックアウトを元に戻す必要があるファイルの名前。

DiscardCheckOutDocument アクションの構成方法については、アクションの例をご覧ください。

CopyDocument アクション

このアクションにより、ファイルをある場所から別の場所にコピーできます。

CopyDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
SourceFileRelativeUrl 文字列 ソースファイルの相対 URL。
DestFileRelativeUrl 文字列 宛先ファイルの相対 URL。

CopyDocument アクションの構成方法については、アクションの例をご覧ください。

UploadDocument アクション

このアクションにより、ファイルをアップロードできます。

UploadDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
FileName 文字列 アップロードするファイルの名前。
RelativeUrl 文字列 フォルダの相対 URL。
Content 文字列 × ファイルとしてアップロードするコンテンツ。
ContentBytes 文字列 × ファイルとしてアップロードするバイト コンテンツ(Base64 文字列として)。バイナリデータをアップロードする場合に使用します。
HasBytes ブール値 × アップロードするコンテンツがバイナリかどうかを指定します。デフォルト値は false です。

UploadDocument アクションの構成方法については、アクションの例をご覧ください。

DownloadDocument アクション

このアクションにより、ファイルをダウンロードできます。

DownloadDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RemoteFile 文字列 ダウンロードするファイルの完全な URL。
ライブラリ 文字列 SharePoint サーバー上のライブラリの名前。
HasBytes ブール値 × コンテンツをバイトとしてダウンロードするかどうかを指定します。デフォルト値は false です。

DownloadDocument アクションの構成方法については、アクションの例をご覧ください。

MoveAttachmentOrDocument アクション

このアクションにより、ファイルをフォルダ間で移動できます。

MoveAttachmentOrDocument アクションの入力パラメータ

パラメータ名 データ型 必須 説明
SourceFileURL 文字列 移動する必要があるソースファイルの URL。
DestinationFolderURL 文字列 宛先フォルダの URL。

MoveAttachmentOrDocument アクションの構成方法については、アクションの例をご覧ください。

CreateFolder アクション

このアクションにより、フォルダを作成できます。

CreateFolder アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RelativeURL 文字列 フォルダの相対 URL。
FolderName 文字列 作成するフォルダの名前。

CreateFolder アクションの構成方法については、アクションの例をご覧ください。

AddAttachments アクション

このアクションにより、添付ファイルを追加できます。

AddAttachments アクションの入力パラメータ

パラメータ名 データ型 必須 説明
ListTitle 文字列 添付ファイルリストの名前。
FileName 文字列 添付ファイルの名前。
ItemId 文字列 追加する添付ファイルの ID。
Content 文字列 添付ファイルのコンテンツ。
ContentBytes 文字列 × 添付ファイルとしてアップロードするバイト コンテンツ(Base64 文字列として)。バイナリデータをアップロードする場合に使用します。
HasBytes ブール値 × アップロードするコンテンツがバイナリかどうかを指定します。デフォルト値は false です。

AddAttachments アクションの構成方法については、アクションの例をご覧ください。

DownloadAttachments アクション

このアクションにより、添付ファイルをダウンロードできます。

DownloadAttachments アクションの入力パラメータ

パラメータ名 データ型 必須 説明
RemoteFile 文字列 ファイルの相対 URL。
HasBytes ブール値 × ダウンロードするコンテンツがバイナリかどうかを指定します。デフォルト値は false です。

DownloadAttachments アクションの構成方法については、アクションの例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - 添付ファイルを削除する

この例では、指定したファイルを削除します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DeleteAttachment] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "ListTitle": "My lists",
    "ItemId": "1",
    "FileName": "sitepages.txt"
    }
  4. アクションが成功すると、DeleteAttachment タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - ドキュメントをチェックインする

この例では、ドキュメントをチェックインします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CheckInDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.txt",
    "Comment": "Comment test"
    }
  4. アクションが成功すると、CheckInDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - ファイルをチェックアウトする

この例では、ファイルをチェックアウトします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CheckOutDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.txt"
    }
  4. アクションが成功すると、CheckOutDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - チェックアウトを破棄する

この例では、ファイルのチェックアウトを元に戻します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DiscardCheckOutDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "DocumentName": "Document.docx"
    }
  4. アクションが成功すると、DiscardCheckOutDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - ファイルをコピーする

この例では、ファイルをある場所から別の場所にコピーします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CopyDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
    "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
    }
  4. アクションが成功すると、CopyDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - テキスト ファイルをアップロードする

この例では、テキスト ファイルを指定した場所にアップロードします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [UploadDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "FileName": "test.txt",
    "RelativeUrl": "/Shared Documents/TestFolder",
    "Content": "abcd"
    }
  4. アクションが成功すると、UploadDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - バイナリ ファイルをアップロードする

この例では、バイナリ ファイルを指定した場所にアップロードします。バイナリ ファイルをアップロードする場合は、アップロードするコンテンツを Base64 でエンコードされた文字列として指定します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [UploadDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "FileName": "test.txt",
    "RelativeUrl": "/Shared Documents/TestFolder",
    "ContentBytes": "SGVsbG8gd29ybGQK",
    "HasBytes": "true"
    }
  4. アクションが成功すると、UploadDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]

例 - ファイルをダウンロードする

この例では、ファイルをダウンロードします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DownloadDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RemoteFile": "/TestFolder/test.txt",
    "Library": "Shared Documents"
    }
  4. アクションが成功すると、DownloadDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "True",
    "Content": "Test File",
    }]

例 - バイナリ ファイルをダウンロードする

この例では、バイナリ ファイルをダウンロードします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DownloadDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RemoteFile": "/TestFolder/test1.png",
    "Library": "Shared Documents"
    "HasBytes": "true"  
    }
  4. アクションが成功すると、DownloadDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "True",
    "ContentBytes": "VGVzdCBGaWxl",
    }]

例 - 添付ファイルを移動する

この例では、添付ファイルをある場所から別の場所に移動します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [MoveAttachmentOrDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "SourceFileURL": "/Shared Documents/test.txt",
    "DestinationFolderURL": "/Shared Documents/TestFolder"
    }
  4. アクションが成功すると、MoveAttachmentOrDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Result": "Success"
    }]

例 - フォルダを作成する

この例では、指定された場所にフォルダを作成します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CreateFolder] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RelativeURL": "/Shared Documents/TestFolder",
    "FolderName": "TestFolder123"
    }
  4. アクションが成功すると、CreateFolder タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
    "Status": "Success"
    }]

例 - 添付ファイルを追加する

この例では、指定したリストに添付ファイルを追加します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [AddAttachments] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "ListTitle": "My Lists",
    "FileName": "TestAttachment2",
    "Content": "abcd text",
    "ItemId": "1"
    }
  4. アクションが成功すると、AddAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
    "Status": "Success"
    }]

例 - バイナリの添付ファイルを追加する

この例では、指定したリストにバイナリの添付ファイルを追加します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [AddAttachments] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "ListTitle": "My Lists",
    "FileName": "TestAttachment3",
    "ContentBytes": "VGVzdCBGaWxl",
    "HasBytes": "true",  
    "ItemId": "1"
    }
  4. アクションが成功すると、AddAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
    "Status": "Success"
    }]

例 - 添付ファイルをダウンロードする

この例では、添付ファイルをダウンロードします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DownloadAttachments] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RemoteFile": "/Shared Documents/Document.txt"
    }
  4. アクションが成功すると、DownloadAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "True",
    "Content": "Test File",
    }]

例 - バイナリ添付ファイルをダウンロードする

この例では、バイナリ添付ファイルをダウンロードします。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DownloadAttachments] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "RemoteFile": "/Shared Documents/Document.docx",
    "HasBytes": "true"
    }
  4. アクションが成功すると、DownloadAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "True",
    "ContentBytes": "VGVzdCBGaWxl",
    }]

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - すべてのファイルを一覧表示する

この例では、Files エンティティ内のすべてのファイルを一覧表示します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Files を選択します。
  3. [List] オペレーションを選択してから、[完了] をクリックします。
  4. 必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。 論理演算子を使用して複数のフィルタ条件を指定することもできます。

例 - リストを取得する

この例では、My Lists エンティティから、指定した ID のリストを取得します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から My Lists を選択します。
  3. [Get] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタタスクの [タスク入力 セクションで [entityId] をクリックし、[デフォルト値] フィールドに 3 を入力します。

    ここで、3My Lists エンティティの主キー値です。

例 - レコードを作成する

この例では、My Lists エンティティに レコードを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から My Lists を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "AuthorId": 11.0, 
    "BaseName": "3_",
    "Attachments": false,
    "Title": "Created List New"
    }

    統合に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

    [{
    "ID": 3.0
    }]

例 - レコードを削除する

この例では、My Lists エンティティ内の指定された ID のレコードを削除します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から My Lists を選択します。
  3. [Delete] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタタスクの [タスク入力 セクションで [entityId] をクリックし、[デフォルト値] フィールドに 2 を入力します。

統合で SharePoint 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

  • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
  • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

次のステップ