그래프 API 버전

Generatepreviews

읽기

Endpoint to generate preview without using any Facebook specific assets (e.g. adaccount)

매개변수

매개변수	설명
`ad_format` enum{AUDIENCE_NETWORK_INSTREAM_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE, AUDIENCE_NETWORK_OUTSTREAM_VIDEO, AUDIENCE_NETWORK_REWARDED_VIDEO, BIZ_DISCO_FEED_MOBILE, DESKTOP_FEED_STANDARD, FACEBOOK_PROFILE_FEED_DESKTOP, FACEBOOK_PROFILE_FEED_MOBILE, FACEBOOK_PROFILE_REELS_MOBILE, FACEBOOK_REELS_BANNER, FACEBOOK_REELS_BANNER_DESKTOP, FACEBOOK_REELS_MOBILE, FACEBOOK_REELS_POSTLOOP, FACEBOOK_REELS_STICKER, FACEBOOK_STORY_MOBILE, FACEBOOK_STORY_STICKER_MOBILE, INSTAGRAM_EXPLORE_CONTEXTUAL, INSTAGRAM_EXPLORE_GRID_HOME, INSTAGRAM_EXPLORE_IMMERSIVE, INSTAGRAM_FEED_WEB, INSTAGRAM_FEED_WEB_M_SITE, INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS, INSTAGRAM_PROFILE_FEED, INSTAGRAM_PROFILE_REELS, INSTAGRAM_REELS, INSTAGRAM_REELS_OVERLAY, INSTAGRAM_SEARCH_CHAIN, INSTAGRAM_SEARCH_GRID, INSTAGRAM_STANDARD, INSTAGRAM_STORY, INSTAGRAM_STORY_EFFECT_TRAY, INSTAGRAM_STORY_WEB, INSTAGRAM_STORY_WEB_M_SITE, INSTANT_ARTICLE_RECIRCULATION_AD, INSTANT_ARTICLE_STANDARD, INSTREAM_BANNER_DESKTOP, INSTREAM_BANNER_FULLSCREEN_MOBILE, INSTREAM_BANNER_IMMERSIVE_MOBILE, INSTREAM_BANNER_MOBILE, INSTREAM_VIDEO_DESKTOP, INSTREAM_VIDEO_FULLSCREEN_IOS, INSTREAM_VIDEO_FULLSCREEN_MOBILE, INSTREAM_VIDEO_IMAGE, INSTREAM_VIDEO_IMMERSIVE_MOBILE, INSTREAM_VIDEO_MOBILE, JOB_BROWSER_DESKTOP, JOB_BROWSER_MOBILE, MARKETPLACE_MOBILE, MESSENGER_MOBILE_INBOX_MEDIA, MESSENGER_MOBILE_STORY_MEDIA, MOBILE_BANNER, MOBILE_FEED_BASIC, MOBILE_FEED_STANDARD, MOBILE_FULLWIDTH, MOBILE_INTERSTITIAL, MOBILE_MEDIUM_RECTANGLE, MOBILE_NATIVE, RIGHT_COLUMN_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_FULLSCREEN_MOBILE, SUGGESTED_VIDEO_IMMERSIVE_MOBILE, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_HOME, WATCH_FEED_MOBILE}	Use this to select what placement on Facebook the ad preview should be for. The API returns an iframe, which is only valid for 24 hours. 필수
`creative` AdCreative	Creative spec that is used to generate preview 필수이모티콘 지원
`creative_feature` enum{product_metadata_automation, profile_card, standard_enhancements_catalog}	creative_feature
`dynamic_asset_label` string	Provide a label for rendering specific variation of an asset customization ad
`dynamic_creative_spec` Object	Dynamic creative spec for dynamic ads. 이모티콘 지원
`dynamic_customization` Object	For dynamic ads in multiple languages, specify the customization to be applied to the ad
`end_date` datetime	Provide an end date for trip.* parameters in the creative
`height` int64	Custom height of the resulting iframe, recommended at least 280 x 280 for the large right hand size height. Note: the parameter affects only the size of the iframe containing the preview object. It has no affect on the actual size of the previewed ad.
`place_page_id` Page ID	Place page ID to use when rendering a dynamic local ad preview
`post` Object	Specs for a page post. This field is used when the creative field contains only a Page id as `object_id` in it. Not supported for `ad_format = RIGHT_COLUMN_STANDARD`
`link` URL	Destination URL of the ad 필수
`message` UTF-8 string	Post message 이모티콘 지원
`picture` URL	Image URL
`name` UTF-8 encoded string	Post name
`caption` UTF-8 encoded string	Post caption
`description` UTF-8 encoded string	Post description
`call_to_action` Object	Call to action 이모티콘 지원
`type` enum{BOOK_TRAVEL, CONTACT_US, DONATE, DONATE_NOW, DOWNLOAD, GET_DIRECTIONS, GO_LIVE, INTERESTED, LEARN_MORE, LIKE_PAGE, MESSAGE_PAGE, RAISE_MONEY, SAVE, SEND_TIP, SHOP_NOW, SIGN_UP, VIEW_INSTAGRAM_PROFILE, INSTAGRAM_MESSAGE, LOYALTY_LEARN_MORE, PURCHASE_GIFT_CARDS, PAY_TO_ACCESS, SEE_MORE, TRY_IN_CAMERA, WHATSAPP_LINK, BOOK_NOW, CHECK_AVAILABILITY, ORDER_NOW, WHATSAPP_MESSAGE, GET_MOBILE_APP, INSTALL_MOBILE_APP, USE_MOBILE_APP, INSTALL_APP, USE_APP, PLAY_GAME, WATCH_VIDEO, WATCH_MORE, OPEN_LINK, NO_BUTTON, LISTEN_MUSIC, MOBILE_DOWNLOAD, GET_OFFER, GET_OFFER_VIEW, BUY_NOW, BUY_TICKETS, UPDATE_APP, BET_NOW, ADD_TO_CART, SELL_NOW, GET_SHOWTIMES, LISTEN_NOW, GET_EVENT_TICKETS, REMIND_ME, SEARCH_MORE, PRE_REGISTER, SWIPE_UP_PRODUCT, SWIPE_UP_SHOP, PLAY_GAME_ON_FACEBOOK, VISIT_WORLD, OPEN_INSTANT_APP, JOIN_GROUP, GET_PROMOTIONS, SEND_UPDATES, INQUIRE_NOW, VISIT_PROFILE, CHAT_ON_WHATSAPP, EXPLORE_MORE, CONFIRM, JOIN_CHANNEL, MAKE_AN_APPOINTMENT, ASK_ABOUT_SERVICES, BOOK_A_CONSULTATION, GET_A_QUOTE, BUY_VIA_MESSAGE, ASK_FOR_MORE_INFO, CHAT_WITH_US, VIEW_PRODUCT, VIEW_CHANNEL, CALL, MISSED_CALL, CALL_NOW, CALL_ME, APPLY_NOW, BUY, GET_QUOTE, SUBSCRIBE, RECORD_NOW, VOTE_NOW, GIVE_FREE_RIDES, REGISTER_NOW, OPEN_MESSENGER_EXT, EVENT_RSVP, CIVIC_ACTION, SEND_INVITES, REFER_FRIENDS, REQUEST_TIME, SEE_MENU, SEARCH, TRY_IT, TRY_ON, LINK_CARD, DIAL_CODE, FIND_YOUR_GROUPS, START_ORDER}	The type of the action. Not all types can be used for all ads. Check Ads Product Guide to see which type can be used for based on the `objective` of your campaign. 필수
`value` Object	기본 값: `Vec` JSON containing the call to action data. 이모티콘 지원
`link` URL
`app_link` string
`page` numeric string or integer
`link_format` enum {VIDEO_LEAD, VIDEO_LPP, VIDEO_NEKO, VIDEO_NON_LINK, VIDEO_SHOP, WHATSAPP_CATALOG_ATTACHMENT}
`application` numeric string or integer
`link_title` string	이모티콘 지원
`link_description` string	이모티콘 지원
`link_caption` string
`product_link` string
`get_movie_showtimes` boolean
`sponsorship` Object
`link` URL
`image` URL
`video_annotation` Object
`annotations` list<Object>
`start_time_in_sec` int64
`end_time_in_sec` int64
`link` URL
`link_title` string
`link_description` string
`link_caption` string
`image_url` URL
`header_color` string
`logo_url` URL
`post_click_cta_title` string
`post_click_description_title` string
`offer_id` numeric string or integer
`offer_view_id` numeric string or integer
`advanced_data` Object
`offer_id` numeric string or integer
`lead_gen_form_id` numeric string or integer
`referral_id` numeric string or integer
`fundraiser_campaign_id` numeric string or integer
`event_id` numeric string or integer
`event_tour_id` numeric string or integer
`app_destination` enum {MESSENGER, MESSENGER_EXTENSIONS, MESSENGER_GAMES, LINK_CARD, MARKETPLACE, WHATSAPP, INSTAGRAM_DIRECT}
`app_destination_page_id` numeric string or integer
`is_canvas_video_transition_enabled` boolean
`whatsapp_number` string
`preinput_text` string
`customized_message_page_cta_text` string
`external_offer_provider_id` numeric string or integer
`origins` enum {COMPOSER, CAMERA}
`object_store_urls` array<string>
`facebook_login_spec` Object
`facebook_login_app_id` numeric string or integer
`offer_type` enum {NO_OFFER, PERCENTAGE_BASED, AMOUNT_BASED}
`offer_pct_call_to_action` enum {TEN}
`offer_amt_call_to_action` enum {TEN}
`product_id` numeric string or integer
`group_id` numeric string or integer
`channel_id` string
`land_on_whatsapp_catalog` enum{1, 2}
`photo_replacement_preview_fbid`
`product_item_ids` list<string>	A list of Product Item IDs to use when rendering a dynamic ad preview.
`start_date` datetime	Provide a start date for trip.* parameters in the creative
`width` int64	Custom width of the resulting iframe, recommended at least 280 x 280 for the large right hand size widths. Note: the parameter affects only the size of the iframe containing the preview object. It has no affect on the actual size of the previewed ad.

필드

이 에지로부터 읽는 경우 JSON 형식의 결과를 반환합니다:

{
    "data": [],
    "paging": {}
}

`data`

AdPreview 노드 리스트.

`paging`

페이지 매김에 대한 자세한 정보는 그래프 API 가이드를 확인하세요.

오류 코드

오류	설명
194	Missing at least one required parameter
100	Invalid parameter
105	The number of parameters exceeded the maximum for this operation
104	Incorrect signature

만들기

이 엔드포인트에서 수행할 수 없는 작업입니다.

업데이트 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

삭제 중

이 엔드포인트에서 수행할 수 없는 작업입니다.