game.achievement

This object type represents a specific achievement in a game. An app must be in the 'Games' category in App Dashboard to be able to use this object type. Every achievement has a game:points value associate with it. This is not related to the points the user has scored in the game, but is a way for the app to indicate the relative importance and scarcity of different achievements: * Each game gets a total of 1,000 points to distribute across its achievements * Each game gets a maximum of 1,000 achievements * Achievements which are scarcer and have higher point values will receive more distribution in Facebook's social channels. For example, achievements which have point values of less than 10 will get almost no distribution. Apps should aim for between 50-100 achievements consisting of a mix of 50 (difficult), 25 (medium), and 10 (easy) point value achievements Read more on how to use achievements in this guide.

Markup
 <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# game: http://ogp.me/ns/game#">
  <meta property="fb:app_id"   content="302184056577324" /> 
  <meta property="og:type"     content="game.achievement" /> 
  <meta property="og:url"      content="Put your own URL to the object here" /> 
  <meta property="og:title"    content="Sample Game Achievement" /> 
  <meta property="og:image"    content="https://s-static.ak.fbcdn.net/images/devsite/attachment_blank.png" /> 
  <meta property="game:points" content="Sample Points" /> 
Create
/* make the API call */
FB.api(
    "/me/objects/game.achievement",
    "POST",
    {
        "object": "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\\\/\\\/s-static.ak.fbcdn.net\\\/images\\\/devsite\\\/attachment_blank.png\",\"game:points\":\"Sample Points\"}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"object": @"{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\",\"game:points\":\"Sample Points\"}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/objects/game.achievement"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("object", "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\",\"game:points\":\"Sample Points\"}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/objects/game.achievement",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/me/objects/game.achievement',
  array (
    'object' => '{"fb:app_id":"302184056577324","og:type":"game.achievement","og:url":"Put your own URL to the object here","og:title":"Sample Game Achievement","og:image":"https:\\/\\/s-static.ak.fbcdn.net\\/images\\/devsite\\/attachment_blank.png","game:points":"Sample Points"}',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/me/objects/game.achievement HTTP/1.1
Host: graph.facebook.com

object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22game.achievement%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Game+Achievement%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%2C%22game%3Apoints%22%3A%22Sample+Points%22%7D
curl -X POST \
     -d "object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22game.achievement%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Game+Achievement%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%2C%22game%3Apoints%22%3A%22Sample+Points%22%7D" \
        https://graph.facebook.com/v2.10/me/objects/game.achievement
Read
/* make the API call */
FB.api(
    "/me/objects/game.achievement",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/objects/game.achievement"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/objects/game.achievement",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/me/objects/game.achievement'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
GET /v2.10/me/objects/game.achievement HTTP/1.1
Host: graph.facebook.com
curl https://graph.facebook.com/v2.10/me/objects/game.achievement
Update
/* make the API call */
FB.api(
    "/id_from_create_call",
    "POST",
    {
        "object": "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\\\/\\\/s-static.ak.fbcdn.net\\\/images\\\/devsite\\\/attachment_blank.png\",\"game:points\":\"Sample Points\"}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"object": @"{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\",\"game:points\":\"Sample Points\"}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("object", "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"game.achievement\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Game Achievement\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\",\"game:points\":\"Sample Points\"}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/id_from_create_call',
  array (
    'object' => '{"fb:app_id":"302184056577324","og:type":"game.achievement","og:url":"Put your own URL to the object here","og:title":"Sample Game Achievement","og:image":"https:\\/\\/s-static.ak.fbcdn.net\\/images\\/devsite\\/attachment_blank.png","game:points":"Sample Points"}',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com

object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22game.achievement%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Game+Achievement%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%2C%22game%3Apoints%22%3A%22Sample+Points%22%7D
curl -X POST \
     -d "object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22game.achievement%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Game+Achievement%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%2C%22game%3Apoints%22%3A%22Sample+Points%22%7D" \
        https://graph.facebook.com/v2.10/id_from_create_call
Delete
/* make the API call */
FB.api(
    "/id_from_create_call",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'DELETE',
  '/id_from_create_call'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
DELETE /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com
curl -X DELETE \
     -d "" \
        https://graph.facebook.com/v2.10/id_from_create_call
Properties
NameTypeDescription
FIELDS
game:pointsIntegerThe relative importance and scarcity of the achievement, as described above
game:secretBooleanWhether this achievement is secret and should be hidden from display on Facebook
INHERITED FIELDS
al:androidArray<Struct>
al:android:urlAppsite
al:android:packageAndroidPath
al:android:app_nameString
al:android:classString
al:iosArray<IosApplink>
al:ios:urlAppsite
al:ios:app_store_idInteger
al:ios:app_nameString
al:ipadArray<IosApplink>
al:ipad:urlAppsite
al:ipad:app_store_idInteger
al:ipad:app_nameString
al:iphoneArray<IosApplink>
al:iphone:urlAppsite
al:iphone:app_store_idInteger
al:iphone:app_nameString
al:webStruct
al:web:urlURL
al:web:should_fallbackBoolean
al:windowsArray<Struct>
al:windows:urlAppsite
al:windows:package_family_nameString
al:windows:app_idGuid
al:windows:app_nameString
al:windows_phoneArray<Struct>
al:windows_phone:urlAppsite
al:windows_phone:app_idGuid
al:windows_phone:app_nameString
al:windows_universalArray<Struct>
al:windows_universal:urlAppsite
al:windows_universal:package_family_nameString
al:windows_universal:app_idGuid
al:windows_universal:app_nameString
fb:adminsArray<Facebook ID>An array of the Facebook IDs of the app's administrators
fb:app_idFacebook IDA Facebook app ID
fb:pagesArray<Facebook ID>
fb:profile_idProfileThe Facebook ID of a user that can be followed
og:audioArray<Audio>
og:audio:urlStringThe URL of an audio resource associated with the object
og:audio:secure_urlURLAn alternate URL to use if an audio resource requires HTTPS
og:audio:typeStringThe MIME type of an audio resource associated with the object
og:descriptionStringA short description of the object
og:determinerEnumThe word that appears before the object's title in a sentence. This is an list of words from 'a', 'an', 'the', ' "" ', or 'auto'. If 'auto' is chosen, the consumer of the object will chose between 'a' or 'an'. The default is the blank, "".
og:imageArray<Image>
og:image:urlURLThe URL of an image resource associated with the object
og:image:secure_urlURLAn alternate URL to use if an image resource requires HTTPS
og:image:typeStringThe MIME type of an image resource
og:image:widthIntegerThe width of an image resource in pixels
og:image:heightIntegerThe height of an image resource in pixels
og:image:altString
og:image:user_generatedBoolean
og:localeLocaleNot supported
og:locale:localeEnum
og:locale:alternateArray<Enum>Not supported
og:restrictionsRestrictions
og:restrictions:countryStruct
og:restrictions:country:allowedArray<Country>A whitelist country restriction for the object using a two-letter country code, such as 'US' (may not be used with og:restrictions:country:disallowed)
og:restrictions:country:disallowedArray<Country>A blacklist country restriction for the object using a two-letter country code, such as 'US' (may not be used with og:restrictions:country:allowed)
og:restrictions:ageAgeAn age restriction for the object, such as '13+', '18+'
og:restrictions:contentArray<Content>A content restriction for the object, such as 'alcohol' (the only currently supported value)
og:rich_attachmentBoolean
og:see_alsoArray<URL>An array of URLs of related resources
og:site_nameStringNot supported
og:titleStringThe title of the object as it should appear in the graph
og:ttlInteger
og:typeStringThe type of the object, such as 'article'
og:updated_timeDateTimeThe time when the object was last updated
og:urlURLThe canonical URL of the object, used as its ID in the graph
og:videoArray<Video>
og:video:urlURLThe URL of a video resource associated with the object
og:video:secure_urlURLAn alternate URL to use if a video resource requires HTTPS
og:video:typeStringThe MIME type of a video resource associated with the object
og:video:widthIntegerThe width of a video resource associated with the object in pixels
og:video:heightIntegerThe height of a video resource associated with the object in pixels