Graph API Version

/{app-id}/translations

The strings from this app that were translated using our translations tools.

Reading

GET /v2.10/{app-id}/translations?locale=fr_FR HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{app-id}/translations',
  array (
    'locale' => 'fr_FR',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
Bundle params = new Bundle();
params.putString("locale", "fr_FR");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-id}/translations",
    params,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"locale": @"fr_FR",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{app-id}/translations"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • An app access token is required to return translations for that app.

Modifiers

NameDescriptionType

locale

Specifies which locale of language to request. This is a required parameter when reading this edge.

enum{locale}

Fields

NameDescriptionType

id

A unique ID for each individual string.

string

translation

The translated string.

string

approval_status

The approval status of the string.

enum{auto-approved, approved, unapproved}

native_string

The original string that was translated.

string

description

The provided description of the string.

string

Publishing

You can specify new strings to be translated for your app using this edge:

POST /v2.10/{app-id}/translations HTTP/1.1
Host: graph.facebook.com

native_strings=%5B%7B%22text%22%3A%22Test+String%22%2C+%22description%22%3A+%22This+is+a+test+string+for+an+app.%22%7D%5D
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/{app-id}/translations',
  array (
    'native_strings' => '[{"text":"Test String", "description": "This is a test string for an app."}]',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
Bundle params = new Bundle();
params.putString("native_strings", "[{\"text\":\"Test String\", \"description\": \"This is a test string for an app.\"}]");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-id}/translations",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"native_strings": @"[{\"text\":\"Test String\", \"description\": \"This is a test string for an app.\"}]",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{app-id}/translations"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • An app access token is required to add new translation strings for that app.

Fields

NameDescriptionType

native_strings

The list of strings to add for translation, in an array of objects with the following structure. At least one object must be provided.

object[]

text

The string to be translated. This field is required.

string

description

A description of the string that will help with translation. This field is required.

string

Response

If successful, you will receive a plain response of the number of strings that were added, otherwise an error message.

Deleting

You can delete translation strings using this operation:

DELETE /v2.10/{app-id}/translations HTTP/1.1
Host: graph.facebook.com

native_hashes=%5B%27hash1%27%2C+%27hash2%27%5D
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'DELETE',
  '/{app-id}/translations',
  array (
    'native_hashes' => '[\'hash1\', \'hash2\']',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
Bundle params = new Bundle();
params.putString("native_hashes", "['hash1', 'hash2']");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-id}/translations",
    params,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"native_hashes": @"['hash1', 'hash2']",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{app-id}/translations"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • An app access token is required to delete translation strings from that app.

Fields

NameDescriptionType

native_hashes

An array of hashes for each translation string. The hash is a unique identifier for each string, and can be retrieved using the translation FQL table.

string[]

Response

If successful, you will receive a plain response of the number of strings that were deleted, otherwise an error message.