SharePoint

SharePoint コネクタを使用すると、SharePoint のファイル、フォルダ、添付ファイルを管理できます。

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

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

始める前に

Google Cloud プロジェクトで次のタスクを行います。

  • ネットワーク接続が設定されていることを確認します。詳細については、ネットワーク接続をご覧ください。
  • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
  • コネクタに使用するサービス アカウントに、roles/secretmanager.viewerroles/secretmanager.secretAccessor の IAM ロールを付与します。
  • secretmanager.googleapis.com(Secret Manager API)と connectors.googleapis.com(Connectors API)を有効にします。詳細については、サービスを有効にするをご覧ください。

SharePoint 接続を作成する

接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

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

    [接続] ページに移動

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

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

  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタのリストから [SharePoint] を選択します。
    2. [Connector version] リストからコネクタのバージョンを選択します。SharePoint コネクタには、V1 と V2 の 2 つのバージョンがあります。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。接続名には、小文字、数字、ハイフンを使用できます。名前の先頭は英字、末尾は英字または数字にする必要があります。名前は 49 文字以下にする必要があります。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
    6. [サービス アカウント] フィールドで、必要なロールを持つアカウントを選択します。
    7. 必要に応じて、接続ノードの設定を構成します。

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

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

    8. (省略可)[詳細設定] セクションで、[プロキシを使用する] チェックボックスをオンにして、接続用のプロキシ サーバーを構成し、次の値を構成します。
      • Proxy Auth Scheme: プロキシ サーバーで認証する認証タイプを選択します。次の認証タイプがサポートされています。
        • 基本: 基本的な HTTP 認証。
        • ダイジェスト: ダイジェスト HTTP 認証。
      • Proxy User: プロキシ サーバーでの認証に使用されるユーザー名。
      • プロキシ パスワード: ユーザーのパスワードの Secret Manager シークレット。
      • Proxy SSL Type: プロキシ サーバーへの接続時に使用する SSL タイプ。次の認証タイプがサポートされています。
        • 自動: デフォルトの設定。URL が HTTPS URL の場合は、[トンネル] オプションが使用されます。URL が HTTP URL の場合、[なし] オプションが使用されます。
        • 常に: 接続は常に SSL 対応です。
        • なし: 接続は SSL に対応していません。
        • トンネル: 接続はトンネリング プロキシ経由で行われます。プロキシ サーバーがリモートホストへの接続を開き、トラフィックはプロキシを経由するようになります。
      • [Proxy Server] セクションで、プロキシ サーバーの詳細を入力します。
        1. [+ 宛先を追加] をクリックします。
        2. [宛先の種類] を選択します。
          • Host address: 宛先のホスト名または IP アドレスを指定します。

            バックエンドへのプライベート接続を確立する場合は、次のようにします。

    9. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    10. [次へ] をクリックします。
  5. [宛先] セクションに、接続するリモートホスト(バックエンド システム)の詳細を入力し、[次へ] をクリックします。
  6. [宛先の種類] フィールドで、宛先の種類を選択します。たとえば、ホストアドレスは https://<SITE_NAME>.sharepoint.com です。

    • 宛先のホスト名または IP アドレスを指定するには、[ホストアドレス] を選択し、[ホスト 1] フィールドにアドレスを入力します。
    • プライベート接続を確立するには、[エンドポイント アタッチメント] を選択し、[エンドポイント アタッチメント] リストから必要なアタッチメントを選択します。

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

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

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

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

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

    3. [次へ] をクリックします。
  8. [確認] セクションで、接続と認証の詳細を確認します。
  9. [作成] をクリックします。

認証を構成する

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 で接続を作成するときは、次の詳細を指定する必要があります。

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

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

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
認証 Windows 認証情報
ユーザー名 USER_NAME
パスワード パスワード
シークレットのバージョン 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. [Register] をクリックします。
  5. アプリを作成したら、[証明書とシークレット] ページに移動します。
  6. アプリケーションのクライアント シークレットを作成し、クライアント シークレットの値を保存します。
  7. [API 権限] ページに移動します。
  8. [Add a Permission] をクリックします。
  9. [API のアクセス許可の要求] ダイアログで、次の表から API、タイプ、権限を選択して、アプリケーションでオペレーションを実行します。
  10. 接続を有効にするには、Microsoft Graph API の Sites.Read.All 権限を付与する必要があります。

    API 権限名 タイプ
    Microsoft Graph ConsentRequest.Read.All Application/ Delegated
    Microsoft Graph ConsentRequest.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.Read.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.Read.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.ReadWrite.All Application/ Delegated
    Microsoft Graph Files.Read.All Application/ Delegated
    Microsoft Graph Files.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.FullControl.All Application/ Delegated
    Microsoft Graph Sites.Manage.All Application/ Delegated
    Microsoft Graph Sites.Read.All Application/ Delegated
    Microsoft Graph Sites.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.Selected Application/ Delegated
    Microsoft Graph TermStore.Read.All Application/ Delegated
    Microsoft Graph TermStore.ReadWrite.All Application/ Delegated
    Microsoft Graph User.Export.All Application/ Delegated
    Microsoft Graph User.Read Delegated
    Microsoft Graph User.Read.All Application/ Delegated
    Microsoft Graph User.ReadWrite.All Application/ Delegated
    SharePoint EnterpriseResource.Read Delegated
    SharePoint EnterpriseResource.Write Delegated
    SharePoint Project.Read Delegated
    SharePoint Project.Write Delegated
    SharePoint ProjectWebApp.FullControl Delegated
    SharePoint ProjectWebAppReporting.Read Delegated
    SharePoint TaskStatus.Submit Delegated
  11. 変更を保存します。
  12. 管理者権限が必要な権限を使用するように選択した場合は、[API 権限] ページで現在のテナントから権限を付与できます。
  13. スコープを追加するには、[API を公開する] セクションに移動して AllSites.Manage, Sites.FullControl.All スコープを追加し、制御できるユーザー(管理者とユーザー)を選択します。
  14. [保存] をクリックします。

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

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

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

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

Google Cloudで接続を承認する

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

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

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

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

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

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

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

  1. Azure ポータルで、[Azure サービス> アプリの登録] をクリックします。
  2. アプリ名をクリックします。
  3. [リダイレクト URI を追加] をクリックします。
  4. [プラットフォームを追加] をクリックします。
  5. [ウェブ] ダイアログで、 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?prompt=consent

OAuth 2.0 - JWT Bearer 認証タイプのクライアント認証情報

OAuth 2.0 - JWT ベアラー認証タイプでクライアント認証情報を有効にするには、次の手順を完了する必要があります。

  1. 証明書を作成します
  2. 証明書を Azure ポータルにアップロードします
  3. 秘密鍵を取得します
  4. セットアップを完了します。
  5. Google Cloudで OAuth 2.0 JWT Bearer 認証情報を指定します

証明書を作成する

  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 ポータルに証明書をアップロードする

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

    クライアント シークレットをアプリに追加しないでください。証明書ベースの認証フローが妨げられます。

  7. マニフェストに移動して KeyCredentials を探し、customKeyIdentifier を拇印としてコピーします。この値は後で使用します。これで、アプリを登録して証明書をリンクしました。

秘密鍵を取得する

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

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

セットアップを完了する

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

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

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

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

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

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 ****
認証 JWT Bearer を使用した OAuth 2.0 クライアント認証情報
OAuth クライアント ID CLIENT_ID
秘密鍵 キー
シークレットのバージョン 1
秘密鍵のパスワード パスワード
シークレットのバージョン 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)を使用して、[Register Add-In] ページに移動します。
  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.com/content/tenant" Right="FullControl"/>
          </AppPermissionRequests>
            
  4. [作成] をクリックします。SharePoint アプリに権限の同意ダイアログが表示されます。
  5. [Trust it] をクリックします。

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

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

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

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

認証コードの再認可

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

統合で SharePoint 接続を使用する

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

操作

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

バージョン 1

バージョン 1 でサポートされているアクション

AddAttachments、CheckInDocument、CheckOutDocument、CopyDocument、CreateFolder、DeleteAttachment、DiscardCheckOutDocument、DownloadAttachments、DownloadDocument、MoveAttachmentOrDocument、UploadDocument。

バージョン 2

バージョン 2 でサポートされているアクション

AddAttachments、AddLists、CheckInDocument、CheckInFile、CheckPermission、CheckOutDocument、CopyDocument、CreateFolder、DeleteAttachment、DeleteDocument、DeleteLists、DiscardCheckOutDocument、DownloadAttachments、DownloadDocument、MoveAttachmentOrDocument、UploadDocument。

DeleteAttachment アクション

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

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

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

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

AddLists アクション

このアクションは、ドキュメント ライブラリにリストを追加します。

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

パラメータ名 データ型 必須 説明
テンプレート 文字列 × 使用されたテンプレートの名前。
説明 文字列 × リストの説明。
名前 文字列 × ドキュメント ライブラリに追加するリストの名前。

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

DeleteDocument アクション

この操作を行うと、ドキュメントがライブラリから削除されます。

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

パラメータ名 データ型 必須 説明
ライブラリ 文字列 はい ファイルが保存されているドキュメント ライブラリの名前。
パス 文字列 はい ドキュメントの相対パス。

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

CheckPermission アクション

このアクションは、リストまたはリスト アイテムに対するユーザーまたはグループの権限を確認します。

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

パラメータ名 データ型 必須 説明
ListName 文字列 × リストのタイトル。
プリンシパル 文字列 × ユーザーのログイン名
ItemId 文字列 × リストアイテムの ID。

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

DeleteLists アクション

このアクションにより、ドキュメント ライブラリ内のリストが削除されます。

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

パラメータ名 データ型 必須 説明
名前 文字列 × ドキュメント ライブラリで削除するリストの名前。

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

CheckInFile アクション

このアクションにより、ファイルまたはドキュメントがチェックインされます。

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

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

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

CheckOutDocument アクション

このアクションにより、ファイルまたはドキュメントがチェックアウトされます。

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

パラメータ名 データ型 必須 説明
RelativeURL 文字列 はい フォルダの相対 URL。
DocumentName 文字列 はい ファイルの名前。

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

CheckInDocument アクション

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

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

パラメータ名 データ型 必須 説明
RelativeURL 文字列 はい フォルダの相対 URL。
DocumentName 文字列 はい ファイルの名前。
コメント 文字列 × チェックインのコメント。

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

DiscardCheckOutDocument アクション

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

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

パラメータ名 データ型 必須 説明
RelativeURL 文字列 はい フォルダの相対 URL。
DocumentName 文字列 はい ファイルの名前。

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

CopyDocument アクション

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

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

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

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

UploadDocument アクション

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

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

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

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

DownloadDocument アクション

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

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

パラメータ名 データ型 必須 説明
RemoteFile 文字列 はい ドキュメントの URL。完全 URL または相対 URL のいずれかを指定できます。
ライブラリ 文字列 はい ライブラリの名前。
HasBytes ブール値 × このパラメータは、コンテンツをバイトとしてダウンロードするかどうかを指定します。デフォルト値は false です。

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

MoveAttachmentOrDocument アクション

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

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

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

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

CreateFolder アクション

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

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

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

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

AddAttachments アクション

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

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

パラメータ名 データ型 必須 説明
ListTitle 文字列 はい 添付ファイルリストの名前。
FileName 文字列 はい 添付ファイルの名前。
ItemId 文字列 はい 追加する添付ファイルの ID。
コンテンツ 文字列 添付ファイルのコンテンツ。
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. [CheckInFile] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
      "RelativeURL": "/Shared Documents/TestFolder",
      "DocumentName": "Document.docx",
      "Comment": "Comment test with more than 1 word"
    }
    
  4. アクションが成功すると、CheckInFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Status": "Success"
    }]
    

例 - ライブラリにリストを追加する

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

    [{
    "Status": "Success"
    }]
    

例 - ドキュメントを削除する

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

    [{
    "Status": "Success"
    }]
    

例 - リストの権限を確認する

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

    [{
    "Status": "Success"
    }]
    

例 - リストを削除する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DeleteLists] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
      "Name": "TestList1757601118898"
    }
    
  4. アクションが成功すると、DeleteLists タスクの 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"
    }]

例 - 指定した場所にバイナリ ファイルをアップロードする

  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. [DownloadDocument] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
      "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
      "Library": "Docs",
      "HasBytes": true
    }
    
  4. アクションが成功すると、DownloadDocument タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [
      {
        "Success": "True",
        "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
      }
    ]
    

    特定のサイトからファイルをダウンロードするには、リモート ファイルの完全なアドレスを指定する必要があります。

例 - 添付ファイルを別の場所に移動する

  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",
    }]

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

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

バージョン 1

バージョン 1 でサポートされているエンティティ

[ファイル]、[マイリスト] を選択します。

バージョン 2

バージョン 2 でサポートされているエンティティ

Files、ListItem、My Lists、RoleAssignments、Sharing Links、SitePages、Subsites、Users。

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

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

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

例 - すべてのサイトページを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から SitePages を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

例 - すべてのサブサイトを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Subsites を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

例 - すべてのリストを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から My Lists を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

例 - すべてのユーザーを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Users を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

例 - すべてのアイテムを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から ListItem を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。

例 - すべてのロールの割り当てを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から RoleAssignments を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。
  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Sharing Links を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. entityId を Sharing Links に設定します。entityId を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに 1.0 を入力し、ローカル変数として entityId を選択します。

例 - ファイルの詳細を取得する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Files を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. entityId を Files に設定します。entityId を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqoklbdDZx3Eo0SIWPCsc_L6yI を入力し、ローカル変数として entityId を選択します。
  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Sharing Links を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. entityId を Sharing Links に設定します。entityId を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに 3.0 を入力し、ローカル変数として entityId を選択します。

例 - リストを取得する

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

    ここで、3My 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
    }]
    

例 - リストを削除する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から My Lists を選択します。
  3. [Delete] オペレーションを選択し、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで [entityId] をクリックし、[デフォルト値] フィールドに 2 を入力します。
  • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
  • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

制限事項

SharePoint コネクタには次の制限があります。
  • エンティティ SitePagesEvents の更新オペレーションが機能しません。
  • エンティティ AllFilesAllPagesAllEventsAllListsSites のリスト オペレーションが機能しません。

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

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

次のステップ