Social Engagement からイベントに対する JSON 参照

このトピックは、Microsoft Social Engagement から Microsoft Azure Event Hubs にストリームされるソーシャル投稿の JSON ペイロードのバージョン 2.1 に適用されます。

ペイロードの最新バージョン: バージョン 2.1

注意

バージョン番号を更新しないで、新しいオブジェクトおよびプロパティがペイロードに追加される場合があります。

Social Engagement と Azure Event Hubs の間に接続を設定して使用開始する方法の詳細については、「Social Engagement から Microsoft Azure Event Hubs へのデータのストリーム」を参照してください。

概要

Social Engagement によってイベントが Azure Event Hubs にストリームされるとき、JSON ペイロードが生成されます。 Social Engagement の単一のソーシャル投稿がイベント ハブの単一のイベントになります。 JSON ペイロードには、定義済みのフィルターに一致する単一のソーシャル投稿に関する情報と、ペイロードを生成したオートメーション ルールに対するアクションに関する情報が含まれます。 オートメーション ルールで定義する追加プロパティは、メタデータ オブジェクトの一部です。 メイン コンテンツは、投稿オブジェクトの一部です。

メタデータ オブジェクト要素

この表は、メタデータ オブジェクトのプロパティへのクイック リンクを取得するために使用します。

JSON 要素 説明
メタデータ JSON ペイロード オブジェクト Azure Event Hubs に送信されるペイロードのメタデータを記述している JSON オブジェクトです。
metadata.matchedRules この投稿に一致したオートメーション ルールの配列です。
metadata.matchedRules.id この JSON ペイロードの作成をトリガーしたオートメーション ルールの ID です。
metadata.matchedRules.name この JSON ペイロードの作成をトリガーしたオートメーション ルールの名前です。
metadata.properties オートメーション ルールの [Event Hubs へのストリーム] アクションの追加プロパティで定義された、キーと値のペアの配列です。
metadata.properties.key オートメーション ルールの追加プロパティに指定されたキーと値のペアのキーです。
metadata.properties.value オートメーション ルールの追加プロパティに指定された、キーと値のペアの値です。
metadata.properties.matchedrule 追加プロパティを含むオートメーション ルールの ID です。

トップに戻る

メタデータのサンプル ペイロード

{  
  "metadata": {  
    "matchedRules": [  
      {  
        "id": 12345,  
        "name": "Support Requests"  
      },  
      {  
        "id": 54321,  
        "name": "Company News"  
      }  
    ],  
    "properties": [  
      {  
        "key": "customKey_1",  
        "value": "Some custom value.",  
        "matchedRule": 12345  
        },  

      {  
        "key": "customKey_2",  
        "value": "Some other custom value.",  
        "matchedRule": 54321  
      }  
    ]  
  }  

トップに戻る

投稿オブジェクト要素

この表は、投稿オブジェクトのプロパティへのクイック リンクを取得するために使用します。

JSON 要素 説明
post.id Social Engagement ソリューション データベース内の一意の投稿 ID です。
post.contentType 投稿のコンテンツ タイプです。
post.postType 会話コンテキストの投稿の種類です。
post.uri 投稿の URI — 投稿の元の URI への後方リンクです。
post.title 投稿のメタ情報から配信されるタイトルです。
post.acquisitionDate Social Engagement で投稿が取得されたときのタイムスタンプです (ISO 8601 形式)。
post.modificationDate Social Engagement で投稿が最後に更新されたときのタイムスタンプです (ISO 8601 形式)。
post.publicationDate ソースで投稿が公開されたときのタイムスタンプです (ISO 8601 形式)。
post.profile 投稿の作成者のソーシャル プロファイルを記述している JSON オブジェクトです。
post.source 投稿が見つかったソースを記述している JSON オブジェクトです。
post.content 投稿のコンテンツを記述している JSON オブジェクトです。
post.language 投稿の言語を記述している JSON オブジェクトです。
post.abstractText 投稿の短い抜粋です。
post.score 投稿が公開された時点における投稿のソース固有のスコアまたは作成者のスコアを記述している JSON オブジェクトです。
post.referencedPost この投稿の返信先または共有元の投稿に関する情報です。
post.sentiment 投稿のセンチメントを記述している JSON オブジェクトです。
post.tags Social Engagement を通じて追加された投稿のタグを表している JSON オブジェクトの配列です。
post.externalId ソースの投稿の ID です。
post.postLocation 投稿が公開された場所を記述している JSON オブジェクトです。
post.fullContentLength 投稿のテキスト コンテンツの文字の長さです。
post.origin コンテンツの発生元を記述している JSON オブジェクトです。 例: 投稿が公開された Facebook ページ。
post.matchingSearchTopics 投稿が一致する検索トピックのリストを記述している JSON オブジェクトの配列です。
post.externalCategories データ プロバイダーが配信するカテゴリの配列です。
post.contributors データ プロバイダーによって提供される、投稿に寄与した人の名前の配列です。
post.media 投稿のメディアを記述している JSON オブジェクトの配列です。
post.externalTopics データ プロバイダーが定義したこの投稿のトピックの配列です。
post.contributorSummary 外部のプロバイダーが配信したこの投稿の投稿者に関する簡単な説明です。

トップに戻る

投稿のサンプル ペイロード

Twitter 返信のサンプル

これは、Social Engagement を通じて取得された Twitter 返信のサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "1234567",  
    "contentType": "POST",  
    "postType": "reply",  
    "uri": "http://twitter.com/externalHandle/status/1234567890",  
    "publicationDate": "2016-01-23T12:34:56.789+0000",  
    "acquisitionDate": "2016-01-23T12:34:56.789+0000",  
    "modificationDate": "2016-01-23T12:34:56.789+0000",  
    "profile": {  
      "name": "Display Name @chosenUserName",  
      "id": "41890771",  
      "profileIcon": "https://path/to/the/profileIcon.png",  
      "externalHandle": "chosenUserName",  
      "displayName": "Display Name",  
      "externalId": "7654321"  
    },  
    "source": {  
      "name": "Microblogs",  
      "id": "18",  
      "param": "Twitter"  
    },  
    "content": {  
      "text": "Main text content of the tweet."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Main text content of the tweet.",  
    "score": {  
      "normalScore": 3,  
      "providerScore": 29.0,  
      "provider": "KLOUT"  
    },  
    "referencedPost": {  
      "profile": {  
        "displayName": "Referenced Display Name",  
        "id": "987654321"  
      },  
      "externalId": "123456789",  
    },  
    "sentiment": {  
      "polarity": "negative",  
      "value": -0.46005836  
    },  
        "tags": [  
          {  
            "probability": 0.8339088,  
            "type": "system",  
            "tag": {  
              "name": "Information request",  
              "id": "2473",  
              "parentId": "2470"  
            }  
          }  
        ],  
    "externalId": "12345ab54321",  
    "fullContentLength": 137,  
    "matchingSearchTopics": [  
      {  
        "id": "1234567",  
        "name": "Contoso search topic",  
        "parentId": "7654321"  
      }  
    ],  
  }  
}  

トップに戻る

Twitter リツイートのサンプル

これは、Social Engagement を通じて取得された Twitter リツイートのサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "5786261",  
    "contentType": "POST",  
    "postType": "share",  
    "uri": "http://twitter.com/externalHandle/statuses/1234567890",  
    "publicationDate": "2016-01-23T12:34:56-07:00",  
    "acquisitionDate": "2016-01-23T12:34:56-07:00",  
    "modificationDate": "2016-01-23T12:34:56-07:00",  
    "profile": {  
      "name": "Display Name @chosenUserName",  
      "id": "3464522345",  
      "profileIcon": "https://path/to/the/profileIcon.png",  
      "externalHandle": "chosenUserName",  
      "displayName": "Display Name",  
      "externalId": "7654321"  
    },  
    "source": {  
      "name": "Microblogs",  
      "id": "18",  
      "param": "Twitter"  
    },  
    "content": {  
      "text": "Main text of the tweet."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Main text of the tweet.",  
    "score": {  
      "normalScore": 4,  
      "providerScore": 46.0,  
      "provider": "KLOUT"  
    },  
    "referencedPost": {  
      "profile": {  
        "name": "Display Name of retweeted profile @anotherChosenUserName",  
        "profileIcon": "https://path/to/the/profileIcon.png",  
        "externalHandle": "anotherChosenUserName",  
        "displayName": "Display Name of retweeted profile"  
      },  
      "externalId": "123456789"  
    },  
    "sentiment": {  
      "polarity": "negative",  
      "value": -0.6864638  
    },  
    "tags": [  
      {  
        "probability": 0.8339088,  
        "type": "system",  
        "tag": {  
          "name": "Information request",  
          "id": "2473",  
          "parentId": "2470"  
        }  
      }  
    ],  
    "externalId": "12345ab54321",  
    "fullContentLength": 139,  
    "matchingSearchTopics": [  
      {  
        "name": "Contoso search topic",  
        "id": "12345",  
        "parentId": "54321"  
      }  
    ]  
  }  
}  

トップに戻る

Facebook 返信のサンプル

これは、Social Engagement を通じて取得された Facebook 返信のサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "1234567",  
    "contentType": "POST",  
    "postType": "reply",  
    "uri": "http://www.facebook.com/123456789/posts/987654321?comment_id=123123123",  
    "publicationDate": "2016-01-23T12:34:56-07:00",  
    "acquisitionDate": "2016-01-23T12:34:56-07:00",  
    "modificationDate": "2016-01-23T12:34:56-07:00",  
    "profile": {  
      "name": "Name of the profile",  
      "id": "43214321",  
      "profileIcon": "http://graph.facebook.com/123456789/picture?type=square",  
      "externalId": "123456789"  
    },  
    "source": {  
      "name": "Facebook Posts",  
      "id": "16",  
      "param": "Facebook"  
    },  
    "content": {  
      "text": "Text as provided for the reply. This is usually a text that contains several sentences. This example highlights the difference between post.content and post.abstractText."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Text as provided for the reply. This is usually a",  
    "referencedPost": {  
      "externalId": "987654321"  
    },  
    "sentiment": {  
      "polarity": "neutral",  
      "value": -0.0023945  
    },  
    "externalId": "321321321",  
    "fullContentLength": 227,  
    "origin": {  
      "id": "12345",  
      "externalId": "123456789"  
    },  
    "matchingSearchTopics": [  
      {  
        "name": "Contoso search topic",  
        "id": "12345",  
        "parentId": "54321"  
      }  
    ]  
  }  
}  

トップに戻る

ビデオ投稿のサンプル

これは、Social Engagement を通じて取得されたビデオ投稿のサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "1234567",  
    "contentType": "VIDEO",  
    "postType": "post",  
    "uri": "http://www.youtube.com/watch?v=videoId",  
    "title": "Title of the video",  
    "publicationDate": "2016-01-23T12:34:56-07:00",  
    "acquisitionDate": "2016-01-23T12:34:56-07:00",  
    "modificationDate": "2016-01-23T12:34:56-07:00",  
    "profile": {  
      "name": "Name of the profile",  
      "id": "1234567",  
      "externalId": "98765abc4321"  
    },  
    "source": {  
      "name": "Youtube Videos",  
      "id": "19",  
      "param": "YoutubeVideos"  
    },  
    "content": {  
      "text": "Text description as provided for the video. This is usually a text that contains several sentences. This example highlights the difference between post.content and post.abstractText."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Text description as provided for the video. This is usually a",  
    "embeddedMedia": "http://www.youtube.com/embed/videoId",  
    "media": [  
      {  
        "type": "VIDEO",  
        "embedUrl": "http://www.youtube.com/embed/videoId"  
      }  
    ],  
    "sentiment": {  
      "polarity": "neutral",  
      "value": -0.07142752  
    },  
    "fullContentLength": 358,  
    "matchingSearchTopics": [  
      {  
        "name": "Contoso search topic",  
        "id": "12345",  
        "parentId": "54321"  
      }  
    ]  
  }  
}  

トップに戻る

ブログ投稿のサンプル

これは、Social Engagement を通じて取得されたブログ投稿のサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "1234567",  
    "contentType": "POST",  
    "postType": "post",  
    "uri": "http://someblog.tld/path/to/post",  
    "title": "Heading of this blog",  
    "acquisitionDate": "2016-01-23T12:34:56.789+0000",  
    "modificationDate": "2016-01-23T12:34:56.789+0000",  
    "publicationDate": "2016-01-23T12:34:56.789+0000",  
    "profile": {  
      "name": "Name of the profile",  
      "id": "1234567",  
      "externalId": "987654321"  
    },  
    "source": {  
      "name": "Blogs",  
      "id": "14",  
      "param": "Blogs"  
    },  
    "content": {  
      "text": "Main text content of the blog post. This is usually a text that contains several sentences. This example highlights the difference between post.content.text and post.abstractText."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Main text content of the blog post. This is usually a text that",  
    "sentiment": {  
      "polarity": "positive",  
      "value": 0.3150851  
    },  
    "externalId":"123456789abcd987654321",  
    "fullContentLength": 119,  
    "matchingSearchTopics": [  
      {  
        "id": "1234567",  
        "name": "Contoso search topic",  
        "parentId": "7654321"  
      }  
    ]  
  }  
}  

トップに戻る

フォーラム投稿のサンプル

これは、Social Engagement を通じて取得されたフォーラム投稿のサンプル投稿ペイロードです。 値は、サンプルを匿名にするために作ったものです。

  "post": {  
    "id": "1234567",  
    "contentType": "POST",  
    "postType": "reply",  
    "uri": "http://forumdomain.tld/path/to/the/forum",  
    "publicationDate": "2016-01-23T12:34:56.789+0000",  
    "acquisitionDate": "2016-01-23T12:34:56.789+0000",  
    "modificationDate": "2016-01-23T12:34:56.789+0000",  
    "profile": {  
      "name": "Name of the profile",  
      "id": "1234567",  
      "displayName": "Name of the profile",  
      "externalHandle": "Name of the profile",  
      "externalId": "987654321"  
    },  
    "source": {  
      "name": "Board",  
      "id": "15",  
      "param": "Board"  
    },  
    "content": {  
      "text": "Main text content of the forum post."  
    },  
    "language": {  
      "name": "English",  
      "code": "en"  
    },  
    "abstractText": "Abstract text of the forum post.",  
    "referencedPost": {  
      "externalId":"123456789abcd987654321",  
    },  
    "sentiment": {  
      "polarity": "positive",  
      "value": 0.3773585  
    },  
    "externalId":"123456789abcd987654321",  
    "fullContentLength": 398,  
    "origin": {  
      "externalId":"123ab321",  
      "name":"Title of the forum",  
    },  
    "matchingSearchTopics": [  
      {  
        "id": "1234567",  
        "name": "Contoso search topic",  
        "parentId": "7654321"  
      }  
    ],  
  }  
}  

トップに戻る

メタデータ JSON ペイロード オブジェクト

メタデータ JSON ペイロードで現在サポートされているフィールドを読み取ります。

metadata.matchedRules

この投稿に一致するオートメーション ルールを記述している配列です。

プロパティ値の型: オブジェクト

親: metadata

サンプル: メタデータのサンプル ペイロード

トップに戻る

metadata.matchedRules.id

この JSON ペイロードの作成をトリガーしたオートメーション ルールの ID です。

プロパティ値の型: 数値 (整数)

親: metadata.matchedRules

サンプル: メタデータのサンプル ペイロード

metadata.matchedRules.name

この JSON ペイロードの作成をトリガーしたオートメーション ルールの名前です。

プロパティ値の型: 文字列

親: metadata.matchedRules

サンプル: メタデータのサンプル ペイロード

metadata.properties

オートメーション ルールの [Event Hubs へのストリーム] アクションの追加プロパティで定義された、キーと値のペアの配列です。

プロパティ値の型: オブジェクト

親: metadata

サンプル: メタデータのサンプル ペイロード

トップに戻る

metadata.properties.key

オートメーション ルールの追加プロパティに指定されたキーと値のペアのキーです。

プロパティ値の型: 数値 (整数)

親: metadata.properties

サンプル: メタデータのサンプル ペイロード

metadata.properties.value

オートメーション ルールの追加プロパティに指定された、キーと値のペアの値です。

プロパティ値の型: 文字列

親: metadata.properties

サンプル: メタデータのサンプル ペイロード

metadata.properties.matchedrule

追加プロパティを含むオートメーション ルールの ID です。

プロパティ値の型: 文字列

親: metadata.properties

サンプル: メタデータのサンプル ペイロード

投稿 JSON ペイロード オブジェクト

投稿 JSON ペイロードで現在サポートされているフィールドを読み取ります。

post.id

Social Engagement ソリューション データベース内の一意の投稿 ID です。

プロパティ値の型: 数値 (整数)

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.contentType

投稿のコンテンツ タイプです。

プロパティ値の型: 列挙

プロパティ値:

  • POST: メイン コンテンツはテキストです。

  • IMAGE: メイン コンテンツは画像です。

  • VIDEO: メイン コンテンツはビデオです。

  • LINK: メイン コンテンツはハイパーリンクです。

    親: post

    サンプル: 投稿のサンプル ペイロード

    トップに戻る

post.postType

会話コンテキストの投稿の種類です。

プロパティ値の型: 列挙

プロパティ値:

  • post: 他の投稿が関係している元の投稿です。 会話の始まりと考えることができます。

  • reply: 元の投稿に対する返信またはコメントです。

  • share: 元の投稿の共有またはリツイートです。

  • privatemessage: 2 つ (またはそれ以上) のプロファイル間のプライベートな会話です。

    親: post

    サンプル: 投稿のサンプル ペイロード

    トップに戻る

post.uri

投稿の元の URI への後方リンクです。

注意

新規投稿の URI を元の記事への後方リンクとして使用することはできません。

プロパティ値の型: 文字列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.title

投稿のメタ情報から配信されるタイトルです。

注意

すべての投稿にタイトルがあるとは限りません。

プロパティ値の型: 文字列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.acquisitionDate

Social Engagement で投稿が取得されたときのタイムスタンプです (ISO 8601 形式)。

プロパティ値の型: 日時

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.modificationDate

Social Engagement で投稿が最後に更新されたときのタイムスタンプです (ISO 8601 形式)。

プロパティ値の型: 日時

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.publicationDate

ソースで投稿が公開されたときのタイムスタンプです (ISO 8601 形式)。

プロパティ値の型: 日時

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.profile

投稿の作成者のソーシャル プロファイルを記述している JSON オブジェクトです。

Social Engagement ユーザー インターフェイスでは "作成者" と呼ばれます。 詳細: 何が話題になっているかの確認作成者の詳細の表示

プロパティ値の型: オブジェクト

JSON 要素 説明
post.profile.id Social Engagement ソリューション データベースのプロファイルの一意の ID です。
post.profile.profileIcon 公開プロファイル画像の URI です。
post.profile.profileLocation 作成者が指定した作成者の場所情報を記述している JSON オブジェクトです。
post.profile.externalHandle プロファイルのエイリアスまたはハンドルです。
post.profile.displayName ソースで提供されるプロファイルの表示名です。
post.profile.externalId ソースのプロファイルの ID です。
post.profile.name Social Engagement ユーザー インターフェイスのプロファイルの名前です。

親: post

サンプル:

"profile": {  
  "name": "Display Name @externalHandle",  
  "id": "41890771",  
  "profileIcon": "https://path/to/the/profileIcon.png" ,  
  "profileLocation": {  
    "locality": "Boston",  
    "adminDistrict": "Massachusetts",  
    "countryRegion": "United States",  
    "coordinates": {  
      "latitude": 42.156028747558594,  
      "longitude": -71.56590270996094  
    },  
    "quadKey": "030233212221101333012"  
  },  
  "displayName": "Display Name ",  
  "externalId": "1234567"  
  },  

トップに戻る

post.profile.id

Social Engagement ソリューション データベースのプロファイルの一意の ID です。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.profile.profileIcon

公開プロファイル画像の URI です。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.profile.profileLocation

作成者が指定した作成者の場所情報を記述している JSON オブジェクトです。

一部のソースについては、プロファイル所有者が自分の場所情報を提供できます。 これは、投稿がどこから公開されたかを示す投稿場所ではなく、作成者の場所としてユーザー インターフェイスに表示されます。 投稿場所については、「post.postLocation」を参照してください。

プロパティ値の型: オブジェクト

JSON 要素 説明
post.profile.profileLocation.locality 都市の名前を表します。
post.profile.profileLocation.adminDistrict 連邦国家や州などの行政区分の名前を表します。
post.profile.profileLocation.countryRegion 国または地域の名前を表します。
post.profile.profileLocation.coordinates ソーシャル プロファイルの座標を緯度と経度で記述している JSON オブジェクトです。
post.profile.profileLocation.coordinates.latitude 地理学的な緯度です。
post.profile.profileLocation.coordinates.longitude 地理学的な経度です。
post.profile.profileLocation.quadkey 場所の四分木によるキー (略して "四分キー") です。 マップ上の特定の詳細レベルでの単一のタイルを識別します。

親: post.profile

サンプル:

"profileLocation": {  
  "locality": "Boston",  
  "adminDistrict": "Massachusetts",  
  "countryRegion": "United States",  
  "coordinates": {  
    "latitude": 42.156028747558594,  
    "longitude": -71.56590270996094  
  },  
  "quadKey": "030233212221101333012"  
},  

post.profile.profileLocation.locality

都市の名前を表します。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile.profileLocation

post.profile.profileLocation.adminDistrict

連邦国家や州などの行政区分の名前を表します。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile.profileLocation

post.profile.profileLocation.countryRegion

国または地域の名前を表します。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile.profileLocation

post.profile.profileLocation.coordinates

ソーシャル プロファイルの座標を緯度と経度で記述している JSON オブジェクトです。

サンプル:

"coordinates": {  
  "latitude": 42.156028747558594,  
  "longitude": -71.56590270996094  
},  

post.profile.profileLocation.coordinates.latitude

地理学的な緯度です。

プロパティ値の型: 数値 (浮動小数点)

親: post.profile.profileLocation.coordinates

サンプル: post.profile.profileLocation.coordinates

post.profile.profileLocation.coordinates.longitude

地理学的な経度です。

プロパティ値の型: 数値 (浮動小数点)

親: post.profile.profileLocation.coordinates

サンプル: post.profile.profileLocation.coordinates

post.profile.profileLocation.quadkey

場所の四分木によるキー (略して "四分キー") です。 マップ上の特定の詳細レベルでの単一のタイルを識別します。 詳細: MSDN: Bing 地図のタイル システム

プロパティ値の型: 文字列

親: post.profile.profileLocation

サンプル: post.profile.profileLocation

post.profile.externalHandle

プロファイルのエイリアスまたはハンドルです。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.profile.displayName

ソースで提供されるプロファイルの表示名です。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.profile.externalId

ソースのプロファイルの ID です。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.profile.name

Social Engagement でのプロファイル名の表現です。

プロパティ値の型: 文字列

親: post.profile

サンプル: post.profile

post.source

投稿が見つかったソースを記述している JSON オブジェクトです。

サンプル:

"source": {  
  "name": "Microblogs",  
  "id": "18",  
  "param": "Twitter"  
}  

トップに戻る

post.source.id

投稿が見つかったソースの内部 ID を表します。

プロパティ値の型: 文字列

親: post.source

サンプル: post.source

トップに戻る

post.source.name

投稿が見つかったソースの名前を表します。

プロパティ値の型: 文字列

親: post.source

サンプル: post.source

トップに戻る

post.source.param

投稿が見つかったソースを示します。

プロパティ値の型: 列挙

ソースの可用性は徐々に拡大していきます。 最新のリストについては、リリース発表をこまめに調べて、その内容を確認してください。

親: post.source

サンプル: post.source

トップに戻る

post.content

投稿のテキスト コンテンツを記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

親: post

サンプル:

{  
    “post” {  
        "content": {  
            "text": "Lorem ispum dolor sit amet...",  
            "metaText": "Lorem, dolor, amet",  
        }  
    }  
}  

トップに戻る

post.content.text

投稿のテキスト コンテンツです。

プロパティ値の型: 文字列

親: post.content

サンプル: post.content

post.content.metaText

投稿のメタ テキストです。

プロパティ値の型: 文字列

親: post.content

サンプル: post.content

post.language

投稿の言語を記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

JSON 要素 説明
post.language.name [グローバル設定] で選択されたロケールのローカライズ言語の名前です。
post.language.code 投稿の言語コードです (ISO 639-1 形式)。

親: post

サンプル:

{  
    “post” {  
        "language": {  
            "name": "Finnish",  
            "code": "fi",  
        }  
    }  
}  

トップに戻る

post.language.name

[グローバル設定] で選択されたロケールのローカライズ言語の名前です。

プロパティ値の型: 文字列

親: post.language

サンプル: post.language

post.language.code

投稿の言語コードです (ISO 639-1 形式)。

プロパティ値の型: 文字列

親: post.language

サンプル: post.language

post.abstractText

投稿の短い抜粋です。

プロパティ値の型: 文字列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.score

投稿が公開された時点における投稿のソース固有のスコアまたは作成者のスコアを記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

親: post

サンプル:

"score": {  
  "normalScore": 3,  
  "providerScore": 29.0,  
  "provider": "KLOUT"  
}  

トップに戻る

post.score.normalScore

正規化されたスコアです (最小は 1、最大は 5)。

プロパティ値の型: 数値 (整数)

親: post.score

サンプル: post.score

post.score.providerScore

スコア プロバイダーが提供する正規化されていないスコアです。

プロパティ値の型: 数値 (浮動小数点)

親: post.score

サンプル: post.score

post.score.provider

スコア提供元のスコアリング サービスです。

親: post.score

サンプル: post.score

post.referencedPost

この投稿の返信先または共有元の投稿に関する情報です。 referencedPost は、親投稿と同じ構造ですが、フィールドのサブセットのみにデータが含まれます。

プロパティ値の型: オブジェクト

親: post

サンプル:

{  
    “post” {  
        "referencedPost": {  
            "id": "123456789",  
            "externalId": "654321",  
            "profile": {  
                "id": "123456",  
                "name": "Microsoft"  
            }  
        }  
    }  
}  

トップに戻る

post.sentiment

投稿のセンチメントを記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

親: post

サンプル:

"sentiment": {  
  "polarity": "negative",  
  "value": -0.46005836  
}  

トップに戻る

post.sentiment.polarity

投稿のセンチメント値です。 詳細: 組織のセンチメント値の変化に基づく適応学習センチメント分析を使用した一般大衆の認識の理解

プロパティ値の型: 列挙

プロパティ値:

  • Positive: 投稿のセンチメント値は肯定的です。

  • Negative: 投稿のセンチメント値は否定的です。

  • Neutral: 投稿のセンチメント値が肯定的でも否定的でもありません。

    親: post.sentiment

    サンプル: post.sentiment

post.sentiment.value

センチメント値 (-1 から 1 の間の 10 進値)。

プロパティ値の型: 数値

親: post.sentiment

サンプル: post.sentiment

post.tags

Social Engagement を通じて追加された投稿のタグを表している JSON オブジェクトの配列です。

プロパティ値の型: オブジェクト

JSON 要素 説明
post.tags.probability 投稿にシステム タグが適用されるときに使用される、機械学習モデルによって提供される確率です。
post.tags.type タグがどのように投稿に割り当てられたかを示します。
post.tags.tag タグを記述している JSON オブジェクトです。
post.tags.tag.id タグの内部 ID です。
post.tags.tag.name タグの名前です。 インテンション タグは [グローバル設定] で選択されたロケールでローカライズされます。
post.tags.tag.parentId タグを含むグループの ID です。

親: post

サンプル:

"tags": [ {  
  "probability": 0.7554345,  
  "type": "system",  
  "tag": {  
    "id": "12345",  
    "name": "Support request",  
    "parentId": "54321"  
  }, {...} ]  

トップに戻る

post.tags.probability

投稿にシステム タグが適用されるときに使用される、機械学習モデルによって提供される確率です。

プロパティ値の型: 数値

親: post.tags

サンプル: post.tags

post.tags.type

タグがどのように投稿に割り当てられたかを示します。

注意

オートメーション ルールによって投稿が選択された後でないと、ユーザーは手動でタグを確認することや、タグを投稿に追加することができないため、通常、このプロパティの値は "system" です。

プロパティ値の型: 列挙

プロパティ値:

  • system: Social Engagement によってタグが投稿に追加されました。

  • user: ユーザーが手動でタグを投稿に追加しました。

  • confirmed: Social Engagement によって追加されたタグをユーザーが確認しました。

    親: post.tags

    サンプル: post.tags

post.tags.tag

タグを記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

親: post.tags

サンプル:

"tag": {  
  "id": "12345",  
  "name": "Support request",  
  "parentId": "54321"  
},  

post.tags.tag.id

タグの内部 ID です。

プロパティ値の型: 文字列

親: post.tags.tag

サンプル: post.tags.tag

post.tags.tag.name

タグの名前です。 インテンション タグは [グローバル設定] で選択されたロケールでローカライズされます。 詳細: インテンション分析を使用した作成者の意図の理解

プロパティ値の型: 文字列

親: post.tags.tag

サンプル: post.tags.tag

post.tags.tag.parentId

タグを含むグループの ID です。

プロパティ値の型: 文字列

親: post.tags.tag

サンプル: post.tags.tag

post.externalId

ソースの投稿の ID です。

プロパティ値の型: 文字列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.postLocation

投稿の公開元の場所を記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

JSON 要素 説明
post.postLocation.locality 都市の名前を表します。
post.postLocation.adminDistrict 連邦国家や州などの行政区分の名前を表します。
post.postLocation.countryRegion 国または地域の名前を表します。
post.postLocation.coordinates 作成者が定義した投稿の座標を緯度と経度で記述している JSON オブジェクトです。
post.postLocation.coordinates.latitude 地理学的な緯度です。
post.postLocation.coordinates.longitude 地理学的な経度です。
post.postLocation.quadkey 場所の四分木によるキー (略して "四分キー") です。 マップ上の特定の詳細レベルでの単一のタイルを識別します。

親: post

サンプル:

"postLocation": {  
  "adminDistrict": "Massachusetts",  
  "countryRegion": "United States",  
  "coordinates": {  
    "latitude": 42.156028747558594,  
    "longitude": -71.56590270996094  
  },  
  "quadKey": "030233212221101333012"  
},  

トップに戻る

post.postLocation.locality

都市の名前を表します。

プロパティ値の型: 文字列

親: post.postLocation

サンプル: post.postLocation

post.postLocation.adminDistrict

連邦国家や州などの行政区分の名前を表します。

プロパティ値の型: 文字列

親: post.postLocation

サンプル: post.postLocation

post.postLocation.countryRegion

国または地域の名前を表します。

プロパティ値の型: 文字列

親: post.postLocation

サンプル: post.postLocation

post.postLocation.coordinates

作成者が定義した投稿の座標を緯度と経度で記述している JSON オブジェクトです。

プロパティ値の型: オブジェクト

親: post.postLocation

サンプル:

"coordinates": {  
  "latitude": 42.156028747558594,  
  "longitude": -71.56590270996094  
},  

post.postLocation.coordinates.latitude

地理学的な緯度です。

プロパティ値の型: 数値 (浮動小数点)

親: post.profile.profileLocation.coordinates

サンプル: post.postLocation.coordinates

post.postLocation.coordinates.longitude

地理学的な経度です。

プロパティ値の型: 数値 (浮動小数点)

親: post.postLocation.coordinates

サンプル: post.postLocation.coordinates

post.postLocation.quadkey

場所の四分木によるキー (略して "四分キー") です。 マップ上の特定の詳細レベルでの単一のタイルを識別します。 詳細: MSDN: Bing 地図のタイルシステム

プロパティ値の型: 文字列

親: post.postLocation

サンプル: post.postLocation

トップに戻る

post.fullContentLength

投稿のコンテンツ (テキストのみ) の文字の長さです。

プロパティ値の型: 数値 (整数)

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.origin

ソースの投稿の発生元を記述している JSON オブジェクトです。 これは post.source オブジェクトとは異なります。 例: Facebook ソースの特定の Facebook ページ。

プロパティ値の型: オブジェクト

親: post

サンプル:

"origin": {  
  "id": "12345",  
  "externalId": "54321",  
  "name": "Microsoft Facebook Page",  
},  

トップに戻る

post.origin.id

投稿の発生元を表す Social Engagement の内部表現の ID です。

プロパティ値の型: 文字列

親: post.origin

サンプル: post.origin

post.origin.externalId

投稿の原ソースの発生元の ID です。

プロパティ値の型: 文字列

親: post.origin

サンプル: post.origin

post.origin.name

ソースの投稿の発生元の名前です。

プロパティ値の型: 文字列

親: post.origin

サンプル: post.origin

post.matchingSearchTopics

投稿が一致する検索トピックのリストを記述している JSON オブジェクトの配列です。

プロパティ値の型: オブジェクト

親: post

サンプル:

        "matchingSearchTopics": [{  
          "name": "Contoso Brand Mentions",  
          "id": "12345",  
          "parentId": "54321",  
        },  
{...}]  

トップに戻る

post.matchingSearchTopics.name

Social Engagement で定義された検索トピックの名前です。 詳細: ソーシャル メディアの会話をリスニングするための検索の設定

プロパティ値の型: 文字列

親: post.matchingSearchTopics

サンプル: post.matchingSearchTopics

post.matchingSearchTopics.id

検索トピックの ID です。

プロパティ値の型: 文字列

親: post.matchingSearchTopics

サンプル: post.matchingSearchTopics

post.matchingSearchTopics.parentId

検索トピックのカテゴリの ID です。

プロパティ値の型: 文字列

親: post.matchingSearchTopics

サンプル: post.matchingSearchTopics

post.externalCategories

外部のプロバイダーが配信するカテゴリの配列です。

注意

このプロパティは、ニュース投稿でのみ使用できます。

プロパティ値の型: 文字列の配列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.contributors

データ プロバイダーによって提供される、投稿に寄与した人の名前の配列です。

注意

このプロパティは、ニュース投稿でのみ使用できます。

プロパティ値の型: 文字列の配列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.media

投稿のメディアを記述している JSON オブジェクトの配列です。

プロパティ値の型: オブジェクト

JSON 要素 説明
post.media.type メディア コンテンツの種類です。
post.media.embedUrl メディア ファイルが埋め込まれている URL です。

親: post

サンプル:

"media": {  
  "type": "VIDEO",  
  "embedUrl": "http://www.youtube.com/embed/1dWKf8d8zfg"  
},  

トップに戻る

post.media.type

メディア コンテンツの種類です。

プロパティ値の型: 列挙

プロパティ値:

  • POST: メイン メディア コンテンツはテキストです。

  • IMAGE: メイン メディア コンテンツは画像です。

  • VIDEO: メイン メディア コンテンツはビデオです。

  • LINK: メイン メディア コンテンツはハイパーリンクです。

    親: post.media

    サンプル: post.media

post.media.embedUrl

メディア ファイルが埋め込まれている URL です。

プロパティ値の型: 文字列

親: post.media

サンプル: post.media

post.externalTopics

外部のプロバイダーが配信したこの投稿のトピックの配列です。

プロパティ値の型: 文字列の配列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

post.contributorSummary

外部のプロバイダーが配信したこの投稿の投稿者に関する簡単な説明です。

プロパティ値の型: 文字列

親: post

サンプル: 投稿のサンプル ペイロード

トップに戻る

関連項目

Social Engagement での接続の管理
Social Engagement から Microsoft Azure Event Hubs へのデータのストリーム
Social Engagement から Azure Event Hubs 内のイベントと連携する