LinkedInとの対話

ノート:

統合ストアでは、次の方法で次のレシピを使用できます:

Oracle LinkedInユーザー・ライト・プロファイルの取得
Oracle LinkedIn共有
Oracle LinkedInユーザー・コンテンツの共有

Oracleには、これらのレシピがサンプルとしてのみ用意されています。これらのレシピはガイダンスのみを目的としており、エラーがないことを保証するものではありません。これらのレシピはサポートされていません。

概要

LinkedInレシピでは、RESTアダプタおよびLinkedInアダプタを使用して、LinkedInアプリケーションとの統合を作成します。これらのレシピでは、認証されたユーザーのかわりにOracle Integration内の統合で基本的なLinkedInサービスを使用できます。ユーザー・ライト(基本) LinkedInプロファイルを取得し、LinkedInでコンテンツを共有できます。

レシピ名説明レシピの実行に必要なパラメータ

レシピ名	説明	レシピの実行に必要なパラメータ
ユーザーLiteプロファイルの取得	現在のLinkedInユーザーのライト・プロファイルを取得します。	このレシピを実行するためにリクエスト・メッセージにパラメータは必要ありません。
メッセージの共有	LinkedIn Shares APIを使用して、現在のLinkedInユーザーのアカウントにメッセージを投稿します。ノート: LinkedInはまだShares APIをサポートしていますが、近い将来非推奨になる予定です。また、共有APIはビデオをサポートしていません。	リクエスト・メッセージに次のサンプル・ペイロードを指定します: `{ "content": { "title": "Test Oracle LinkedIn Share message" }, "distribution": { "linkedInDistributionTarget": {} }, "owner": "<your_linkedIn_account_urn>", "subject": "Test Oracle LinkedIn - Share 005", "text": { "text": "Test Oracle LinkedIn Share message" } }`
ユーザー生成コンテンツの共有	LinkedIn User Generated Content (UGC) Posts APIを使用して、現在のLinkedInユーザーのアカウントにメッセージを投稿します。ノート: UGC投稿は、ビデオ投稿や共有投稿などを含む次世代の共有エクスペリエンスのLinkedInです。 UGC投稿は最終的にシェアAPIに置き換わります。	リクエスト・メッセージに次のサンプル・ペイロードを指定します: `{ "author" : "<your_LinkedIn_account_urn>", "lifecycleState" : "PUBLISHED", "specificContent" : { "com.linkedin.ugc.ShareContent" : { "shareCommentary" : { "text" : "Test Oracle LinkedIn Share User Content" }, "shareMediaCategory" : "NONE" } }, "visibility" : { "com.linkedin.ugc.MemberNetworkVisibility" : "PUBLIC" } }`

ユーザーLiteプロファイルの取得

現在のLinkedInユーザーのライト・プロファイルを取得します。

このレシピを実行するためにリクエスト・メッセージにパラメータは必要ありません。

メッセージの共有

LinkedIn Shares APIを使用して、現在のLinkedInユーザーのアカウントにメッセージを投稿します。

ノート: LinkedInはまだShares APIをサポートしていますが、近い将来非推奨になる予定です。また、共有APIはビデオをサポートしていません。

リクエスト・メッセージに次のサンプル・ペイロードを指定します:

{
    "content": { 
      "title": "Test Oracle LinkedIn Share message"
    },
    "distribution": {
       "linkedInDistributionTarget": {}
    },
    "owner": "<your_linkedIn_account_urn>",
    "subject": "Test Oracle LinkedIn - Share 005",
    "text": {
       "text": "Test Oracle LinkedIn Share message"
    }
}

ユーザー生成コンテンツの共有

LinkedIn User Generated Content (UGC) Posts APIを使用して、現在のLinkedInユーザーのアカウントにメッセージを投稿します。

ノート: UGC投稿は、ビデオ投稿や共有投稿などを含む次世代の共有エクスペリエンスのLinkedInです。 UGC投稿は最終的にシェアAPIに置き換わります。

リクエスト・メッセージに次のサンプル・ペイロードを指定します:

{
  "author" : "<your_LinkedIn_account_urn>",
  "lifecycleState" : "PUBLISHED",
  "specificContent" : {
   "com.linkedin.ugc.ShareContent" : {
    "shareCommentary" : {
     "text" : "Test Oracle LinkedIn Share User Content"
    },
    "shareMediaCategory" : "NONE"
   }
  },
  "visibility" : {
  "com.linkedin.ugc.MemberNetworkVisibility" : "PUBLIC"
  } 
}

システムおよびアクセスの要件

Oracle Integration

前提条件

LinkedInレシピを使用するには、接続を作成するための次の前提条件を満たす必要があります:

LinkedIn開発者コンソールにアクセスし、アプリケーションを作成して登録します。

アプリケーションを登録すると、LinkedInによってクライアントIDとクライアント・シークレットが提供されます。クライアントIDとクライアント・シークレットはアプリケーション固有であり、アプリケーションごとに異なります。これらの値は、接続を構成するときに必要になります。
ユーザーのLinkedInプロフィールに対するアクセスの承諾に必要な資格証明があることを確認します。
アクセス・リクエストのスコープを確認します。スコープによって、必要なアクセスのタイプを指定できます。たとえば: r_emailaddress r_liteprofile w_member_social。

「Oracle IntegrationでのLinkedInアダプタの使用」の「接続を作成するための前提条件」を参照してください。

レシピのインストール、構成および実行

レシピのインストール、構成および実行の詳細は、「統合アクセラレータおよびレシピの開始」を参照してください。

LinkedInレシピのコレクションを使用するには、Oracle REST LinkedIn接続およびOracle LinkedIn接続を構成する必要があります。これらの接続を構成する必要があるのは一度だけです。すべてのLinkedInレシピで同じ接続が使用されます。

これらの接続を構成する場合は、次の情報を指定する必要があります。

接続名	パラメータ
Oracle REST LinkedIn接続	タイプ: REST API Base URLConnection URL: `https://oracle_integration_server name:443` セキュリティ・ポリシー: セキュリティ・ポリシーなし
Oracle LinkedIn接続	セキュリティ・ポリシーによって、LinkedInアプリケーションのリソースへの許可アクセス権が付与されます。次のパラメータを指定して、LinkedIn接続のセキュリティを構成します: セキュリティ・ポリシー: カスタム・セキュリティ・ポリシークライアントID: アプリケーションをLinkedInに登録したときに受け取ったクライアントIDを入力します。クライアント・シークレット: アプリケーションをLinkedInに登録したときに受け取ったクライアント・シークレットを入力します。スコープ: アクセス・リクエストのスコープを定義します。スコープを使用すると、必要なアクセスのタイプを指定できます。たとえば: `r_emailaddress r_liteprofile w_member_social` 「承諾の指定」をクリックし、電子メール・アドレスとパスワードを入力して、LinkedInプロファイルへのアプリケーションのアクセスを認可します。「Oracle IntegrationでのLinkedInアダプタの使用」の「接続を作成するための前提条件」を参照してください。

接続名

パラメータ

Oracle REST LinkedIn接続

タイプ: REST API Base URLConnection

URL: https://oracle_integration_server name:443

セキュリティ・ポリシー: セキュリティ・ポリシーなし

Oracle LinkedIn接続

セキュリティ・ポリシーによって、LinkedInアプリケーションのリソースへの許可アクセス権が付与されます。次のパラメータを指定して、LinkedIn接続のセキュリティを構成します:

セキュリティ・ポリシー: カスタム・セキュリティ・ポリシー
クライアントID: アプリケーションをLinkedInに登録したときに受け取ったクライアントIDを入力します。
クライアント・シークレット: アプリケーションをLinkedInに登録したときに受け取ったクライアント・シークレットを入力します。
スコープ: アクセス・リクエストのスコープを定義します。スコープを使用すると、必要なアクセスのタイプを指定できます。たとえば:

r_emailaddress r_liteprofile w_member_social

「承諾の指定」をクリックし、電子メール・アドレスとパスワードを入力して、LinkedInプロファイルへのアプリケーションのアクセスを認可します。

「Oracle IntegrationでのLinkedInアダプタの使用」の「接続を作成するための前提条件」を参照してください。