Built-in Object Types : Facebook開発者向けドキュメントの日本語訳とTips

アプリケーション用の一般的なタイプは既に定義されています。Built-in Actionsはビルトインのオブジェクトとセットで機能するように設計されていますが、ビルトインのオブジェクトと組み合わせるアクションをカスタマイズすることも可能です。ビルトインのオブジェクトタイプを利用するには、Dev Appでそれらを登録する必要があります。

また、Open Graphオブジェクト内で利用するメタタグ群にも定義済みのものがあり、complex typesと呼ばれています。アクション／オブジェクトの表示や要約を助ける為に、できるだけ定義済みのものを利用してください。それぞれのタイプはオブジェクトタイプとは異なりますので、インスタンスを持ちません。むしろcomplex typeの値は、それらのcomplex typeを持つオブジェクトに属するという位置づけです。

Article

Property Name	Description	Type
Title	記事名	`String`
Description	記事の説明	`String`
Image	画像の配列	`Image[]`
URL	記事のOpen Graph URL	`URL`
Published Time	公開日時	`DateTime`
Modified Time	最終更新日時	`DateTime`
Expiration Time	記事が無効になる日時	`DateTime`
Author	著者名の配列	`Profile[]`
Section	記事が現れるセクション	`String`
Tag	記事のキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  article: http://ogp.me/ns/article#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="article"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Name of article">
     <meta property="og:description"          content="Description of object"> 
     <meta property="article:published_time"  content="DateTime"> 
     <meta property="article:modified_time"   content="DateTime"> 
     <meta property="article:expiration_time" content="DateTime">
     <meta property="article:author"          content="URL to Author object">
     <meta property="article:section"         content="Section of article">
     <meta property="article:tag"             content="Keyword">
    </head>
<body>
    <!--a wonderful article  -->
</body>
</html>

Blog

Property Name	Description	Type
Title	ブログ名	`String`
Description	ブログの説明文	`String`
Image	画像の配列	`Image[]`
URL	ブログのOpen Graph URL	`URL`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  blog: http://ogp.me/ns/blog#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="blog"> 
     <meta property="og:url"                  content="URL of this object"> 
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Name of blog">
     <meta property="og:description"          content="Description of object"> 
    </head>
<body>
    <!--a wonderful blog  -->
</body>
</html>

Book

Property Name	Description	Type
Title	本のタイトル	`String`
Description	本の説明	`String`
Image	画像の配列	`Image[]`
URL	本のOpen Graph URL	`URL`
Author	著者名の配列	`Profile[]`
ISBN	本のISBN	`String`
Release Date	出版日	`DateTime`
Tag	本のキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  book: http://ogp.me/ns/book#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="book"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:description"          content="Description of content">
     <meta property="og:title"                content="Name of book">
     <meta property="book:release_date"       content="DateTime">
     <meta property="book:author"             content="Who wrote this">
     <meta property="book:isbn"               content="ISBN Number">
     <meta property="book:tag"                content="keywords">
    </head>
<body>
    <!--a wonderful book -->
</body>
</html>

External Profile

Property Name	Description	Type
Title	個人名	`String`
Description	個人の説明文	`String`
Image	画像の配列	`Image[]`
URL	個人のOpen Graph URL	`URL`
First Name	個人の名	`String`
Last Name	個人の姓	`String`
Username	ユーザ名（存在する場合）	`String`
Gender	性別	`Enum`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  profile: http://ogp.me/ns/profile#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="profile"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Name of User">
     <meta property="og:description"          content="Description of content">
     <meta property="profile:first_name"      content="First Name">
     <meta property="profile:last_name"       content="Last Name">
     <meta property="profile:username"        content="UserName">
     <meta property="profile:gender"          content="male | female">
    </head>
<body>
    <!--a wonderful user profile -->
</body>
</html>

Movie

Property Name	Description	Type
Title	映画のタイトル	`String`
Description	映画の説明文	`String`
Image	画像の配列	`Image[]`
URL	オブジェクトのURL	`URL`
Release Date	公開日	`DateTime`
Duration	上映時間	`Integer`
Actor	俳優の属性の配列	`Struct[Profile, String]`
Director	監督の配列	`Profile[]`
Writer	脚本家の配列	`Profile[]`
Tag	映画のキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  video: http://ogp.me/ns/video#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="video.movie"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Movie title">
     <meta property="og:description"          content="Description of movie">
     <meta property="video:release_date"      content="DateTime">
     <meta property="video:actor"             content="URL to Profile">
     <meta property="video:actor:role"        content="Role in Move">
     <meta property="video:duration"          content="runtime in secs">
     <meta property="video:director"          content="URL to Profile">
     <meta property="video:writer"            content="URL to Profile">
     <meta property="video:tag"               content="keyword">
    </head>
<body>
    <!--a wonderful movie -->
</body>
</html>

TV Episode

Property Name	Description	Type
Title	TVエピソードのタイトル	`String`
Description	TVエピソードの説明文	`String`
Image	画像の配列	`Image[]`
URL	オブジェクトのURL	`URL`
Release Date	放送日	`DateTime`
Duration	エピソードの長さ（時間）	`Integer`
Actor	俳優の属性の配列	`Struct[Profile, String]`
Director	監督の配列	`Profile[]`
Writer	脚本家の配列	`Profile[]`
Series	そのエピソードが属するシリーズ	`URL to a video.tv_show`
Tag	エピソードのキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  video: http://ogp.me/ns/video#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="video.episode"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="TV Episode Name">
     <meta property="og:description"          content="Description of TV Episode">
     <meta property="video:release_date"      content="DateTime">
     <meta property="video:actor"             content="URL to Profile">
     <meta property="video:actor:role"        content="Role in Move">
     <meta property="video:duration"          content="runtime in secs">
     <meta property="video:director"          content="URL to Profile">
     <meta property="video:writer"            content="URL to Profile">
     <meta property="video:series"            content="URL to video:tv_show">
     <meta property="video:tag"               content="keyword">
    </head>
<body>
    <!--a wonderful episode -->
</body>
</html>

TV Show

Property Name	Description	Type
Title	TV番組の名前	`String`
Description	TV番組の説明文	`String`
Image	画像の配列	`Image[]`
URL	オブジェクトのURL	`URL`
Release Date	公開日	`DateTime`
Duration	番組の長さ（時間）	`Integer`
Actor	俳優の属性の配列	`Struct[Profile, String]`
Director	監督の配列	`Profile[]`
Writer	脚本家の配列	`Profile[]`
Tag	番組のキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  video: http://ogp.me/ns/video#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="video.tv_show"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="TV Show Name">
     <meta property="og:description"          content="Description of TV Show">
     <meta property="video:release_date"      content="DateTime">
     <meta property="video:actor"             content="URL to Profile">
     <meta property="video:actor:role"        content="Role in Move">
     <meta property="video:duration"          content="runtime in secs">
     <meta property="video:director"          content="URL to Profile">
     <meta property="video:writer"            content="URL to Profile">
     <meta property="video:tag"               content="keyword">
    </head>
<body>
    <!--a wonderful show -->
</body>
</html>

Video

Property Name	Description	Type
Title	動画のタイトル	`String`
Description	動画の説明	`String`
Image	画像の配列	`Image[]`
URL	オブジェクトのURL	`URL`
Release Date	公開日	`DateTime`
Duration	動画の長さ	`Integer`
Actor	俳優の属性の配列	`Struct[Profile, String]`
Director	監督の配列	`Profile[]`
Writer	脚本家の配列	`Profile[]`
Tag	動画のキーワード	`String[]`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  video: http://ogp.me/ns/video#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="video.other"> 
     <meta property="og:url"                  content="URL of this object">
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Video Title">
     <meta property="og:description"          content="Description of video">
     <meta property="video:release_date"      content="DateTime">
     <meta property="video:actor"             content="URL to Profile">
     <meta property="video:actor:role"        content="Role in Move">
     <meta property="video:duration"          content="runtime in secs">
     <meta property="video:director"          content="URL to Profile">
     <meta property="video:writer"            content="URL to Profile">
     <meta property="video:tag"               content="keyword">
    </head>
<body>
    <!--a wonderful show -->
</body>
</html>

Website

Property Name	Description	Type
Title	ウェブサイト名	`String`
Description	ウェブサイトの説明文	`String`
Image	画像の配列	`Image[]`
URL	ウェブサイトのOpen Graph URL	`URL`

Example

<html>
    <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                  website: http://ogp.me/ns/website#">
     <meta property="fb:app_id"               content="YOUR_APP_ID"> 
     <meta property="og:type"                 content="website"> 
     <meta property="og:url"                  content="URL of this object"> 
     <meta property="og:image"                content="URL to an image">
     <meta property="og:title"                content="Name of blog">
     <meta property="og:description"          content="Description of object"> 
    </head>
<body>
    <!--a wonderful website  -->
</body>
</html>

Complex Types

Audio

音源情報を含むオブジェクトを定義する時にAudioタイプを指定してください（たとえばポッドキャスト、音楽など）

Property Name	Description	Type
URL	音源のURL	`URL`
Secure URL	音源のセキュアURL	`URL`
Type	音源のMIMEタイプ	`String`

Example

<html>
  <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                your-og-app: http://ogp.me/ns/apps/your-og-app#">
  <meta property="fb:app_id"                    content="YOUR_APP_ID"> 
  <meta property="og:type"                      content="your-og-app:restaurant"> 
  <meta property="og:title"                     content="Sample Restaurant"> 
  <meta property="og:description"               content="A great sample restaurant"> 
  <meta property="og:image"                     content="https://your-great-image">
  <meta property="my-og-app:podcast:url"        content="http://my-audio.mp3">
  <meta property="my-og-app:podcast:secure_url" content="http://my-audio.mp3">
  <meta property="my-og-app:podcast:type"       content="audio/mp3"> 
</head>
<body>
    <!--a wonderful web page of Sample Restaurant -->
</body>
</html>

ContactInfo

所在地、電話番号、ウェブサイトの情報を含むオブジェクトを定義する場合にContactInfoタイプを指定してください。

Property Name	Description	Type
Street Address	所在地	`String`
Locality	市町村名	`String`
Region	都道府県名	`String`
Postal Code	郵便番号	`String`
Country Name	国名	`String`
Email Address	メールアドレス	`String`
Phone Number	市外局番付きの電話番号	`String`
Fax Number	市外局番付きの電話番号	`String`
Website	ウェブサイトURL	`URL`

Example

<html>
  <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
       your-og-app: http://ogp.me/ns/apps/your-og-app#">
  <meta property="fb:app_id"                    content="YOUR_APP_ID"> 
  <meta property="og:type"                      content="your-og-app:restaurant"> 
  <meta property="og:title"                     content="Sample Restaurant"> 
  <meta property="og:description"               content="A great sample restaurant"> 
  <meta property="og:image"                     content="https://your-great-image"> 
  <meta property="your-og-app:owner:street_address" 
        content="1601 S. California St."> 
  <meta property="your-og-app:owner:locality"       content="Palo Alto"> 
  <meta property="your-og-app:owner:region"         content="California"> 
  <meta property="your-og-app:owner:postal_code"    content="94304"> 
  <meta property="your-og-app:owner:country_name"   content="United States"> 
  <meta property="your-og-app:owner:email"          content="nospam@fb.com"> 
  <meta property="your-og-app:owner:phone_number"   content="111-111-1111"> 
  <meta property="your-og-app:owner:fax_number"     content="111-111-1111"> 
  <meta property="your-og-app:owner:website"    
        content="http://www.facebook.com">
</head>
<body>
    <!--a wonderful web page of Sample Restaurant -->
</body>
</html>

GeoPoint

空間上の情報を扱う場合にGeoPointタイプを指定してください（たとえば位置情報など）

Property Name	Description	Type
Latitude	緯度	`Float`
Longitude	経度	`Float`
Elevation	標高	`Float`

Example

<html>
  <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
               your-og-app: http://ogp.me/ns/apps/your-og-app#">
  <meta property="fb:app_id"                      content="YOUR_APP_ID"> 
  <meta property="og:type"                        content="your-og-app:restaurant"> 
  <meta property="og:title"                       content="Sample Restaurant"> 
  <meta property="og:description"                 content="A great sample restaurant"> 
  <meta property="og:image"                       content="https://your-great-image"> 
  <meta property="your-og-app:location:latitude"  content="37.416382"> 
  <meta property="your-og-app:location:longitude" content="-122.152659"> 
  <meta property="your-og-app:location:altitude"  content="42">
</head>
<body>
    <!--a wonderful web page of Sample Restaurant -->
</body>
</html>

Image

一つ以上の画像を含むオブジェクトを定義する時にImageタイプを指定してください

Property Name	Description	Type
URL	画像URL	`URL`
Secure URL	画像のセキュアURL	`URL`
Type	画像のMIMEタイプ	`String`
Width	横幅（ピクセル）	`Integer`
Height	高さ（ピクセル）	`Integer`

Example

<html>
  <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                your-og-app: http://ogp.me/ns/apps/your-og-app#">
  <meta property="fb:app_id"                   content="YOUR_APP_ID"> 
  <meta property="og:type"                     content="your-og-app:restaurant"> 
  <meta property="og:title"                    content="Sample Restaurant"> 
  <meta property="og:description"              content="A great sample restaurant"> 
  <meta property="og:image"                    content="https://your-great-image"> 
  <meta property="your-og-app:menu:url"        content="http://menu.png"> 
  <meta property="your-og-app:menu:secure_url" content="https://menu.png"> 
  <meta property="your-og-app:menu:type"       content="image/png"> 
  <meta property="your-og-app:menu:width"      content="200"> 
  <meta property="your-og-app:menu:height"     content="500">
</head>
<body>
    <!--a wonderful web page of Sample Restaurant -->
</body>
</html>

Video

動画を含むオブジェクトを定義する場合にVideoタイプを指定してください

Property Name	Description	Type
URL	動画のURL	`URL`
Secure URL	動画のセキュアURL	`URL`
Type	動画のMIMEタイプ	`String`
Width	動画の横幅（ピクセル）	`Integer`
Height	動画の高さ（ピクセル）	`Integer`

Example

<html>
  <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
                your-og-app: http://ogp.me/ns/apps/your-og-app#">
  <meta property="fb:app_id"                         content="YOUR_APP_ID"> 
  <meta property="og:type"                           content="your-og-app:restaurant"> 
  <meta property="og:title"                          content="Sample Restaurant"> 
  <meta property="og:description"                    content="A great sample restaurant"> 
  <meta property="og:image"                          content="https://your-great-image"> 
  <meta property="your-og-app:commerical:url"        content="http://welcome.here.mp4"> 
  <meta property="your-og-app:commerical:secure_url" content="https://welcome.here.mp4"> 
  <meta property="your-og-app:commerical:type"       content="video/mp4"> 
  <meta property="your-og-app:commerical:width"      content="100"> 
  <meta property="your-og-app:commerical:height"     content="200">
</head>
<body>
    <!--a wonderful web page of Sample Restaurant -->
</body>
</html>

Facebook開発者向けドキュメントの日本語訳とTips