Graph API Version

Ad Creative Link Data Image Layer Spec

Reading

How to render text and frame overlays on an image for a dynamic item in Dynamic Ads

Example

Graph API Explorer
GET v19.0/...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
blending_mode
enum {lighten, multiply, normal}

Combine the product image and frame image together using a certain blend mode. This field is only valid for frame_overlay.

content
AdCreativeLinkDataImageTextOverlayContent

The content of text_overlay. It includes four fields, type, price, low_price and high_price.

frame_image_hash
string

The hash string for a frame image that you can use in creatives.This field is required for frame_overlay.

frame_source
enum {custom}

The source of the frame image. Currently, we only support custom. This field is required for frame_overlay.

image_source
enum {catalog}

The source of the product image. Currently, we only support catalog. This field is required for image layer.

layer_type
enum {frame_overlay, image, text_overlay}

Each layer can be a layer of image, frame_overlay or text_overlay. This field is required for each layer.

opacity
int32

The opacity of the text or frame image. This field is valid for both text_overlay and frame_overlayFor text, the valid values are 75 and 100, For frame image, the valid value is from 10 to 100. The bigger number means more opaque.

overlay_position
enum {bottom, bottom_left, bottom_right, center, left, right, top, top_left, top_right}

Position for overlay on an image. This field is valid for both text_overlay and frame_overlay

overlay_shape
enum {circle, none, pill, rectangle, triangle}

The background shape of text_overlay. The value none means no shape underneath the text.

scale
int32

The scale resizes the frame image by multiples of ten from 10 to 100. 100 means the original size of frame image, 10 means the smallest size.This field is only valid for frame_overlay.

shape_color
string

The color of the background in text_overlay. It should be represented as a three-digit or six-digit hexadecimal number. For example, 09C, FFFFFF.

text_color
string

The color of the text in text_overlay. It should be represented as a three-digit or six-digit hexadecimal number. For example, 09C, FFFFFF.

text_font
enum {droid_serif_regular, lato_regular, noto_sans_regular, nunito_sans_bold, open_sans_bold, open_sans_condensed_bold, pt_serif_bold, roboto_condensed_regular, roboto_medium}

Font type for text strings. If you choose a text font which does not support the language you are using, it will fallback to the default font.This field is only valid for text_overlay.

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.