그래프 API v26.0 및 마케팅 API v26.0 소개

2026년 7월 29일

그래프 API v26.0 및 마케팅 API v26.0 소개

제작: Ayyad Farah, Manjari Jain

그래프 API v26.0 및 마케팅 API v26.0에는 새로운 기능, 사용 중단 사항 및 중대한 변경 사항이 포함되어 있습니다. 아래의 하이라이트를 검토하고 V26.0 변경 사항을 방문하여 변경 사항의 전체 리스트와 상세 정보를 확인하세요.

주요 날짜 및 변경 사항

그래프 API - 커머스 주문 관리: 2026년 7월 29일부터 v26.0 이상의 영향을 받는 엔드포인트에 대한 호출이 차단됩니다. 2026년 10월 27일부터 모든 나머지 그래프 API 버전에서 엔드포인트가 삭제되며 이후에는 호출 시 오류가 반환됩니다. 대체 API를 사용할 수 없습니다.
그래프 API - 권한 관리자 소유자 필드: 2026년 7월 29일부터 v26.0 이상에서는 RightsHolderOwner 유형을 반환하는 대체 필드를 사용할 수 있으며, 사용 중단된 소유자 필드는 더 이상 반환되지 않습니다. 사용 중단된 필드는 v26.0 출시 후 2년간 v25.0 및 이전 버전에서 계속 사용할 수 있습니다.
그래프 API - 레거시 프로토콜 기능: 2026년 7월 29일부터 v26.0 호출에서 5가지 레거시 동작이 삭제됩니다. 2026년 10월 27일부터 나머지 모든 지원되는 그래프 API 버전에도 동일한 동작이 적용됩니다.
마케팅 API - WhatsApp 상태 광고: 2026년 7월 29일부터 v26.0에 확장된 ID, 타게팅, 최적화 및 크리에이티브 기능이 추가됩니다.
마케팅 API - 주택, 고용, 금융 상품 및 서비스 캠페인의 어드밴티지+ 타겟: 2026년 7월 29일부터 v26.0 이상에서 제한적으로 타게팅된 새로운 광고 세트나 복사된 광고 세트는 advantage_audience을 1 또는 0으로 명시적으로 설정해야 합니다. 기본 또는 완화된 설정은 계속해서 기본값을 1로 유지하며, 기존 광고 세트 업데이트에는 영향을 미치지 않습니다.
마케팅 API - Instagram 탐색 탭 피드: 2026년 7월 29일부터 v26.0 이상에서 이 노출 위치를 더 이상 사용할 수 없습니다. 개발자는 노출 위치 구성에서 탐색 탭을 삭제해야 합니다.
마케팅 API - 웹+앱 캠페인의 웹 전용 랜딩 페이지: 2026년 7월 29일 v26.0부터 캠페인이 웹사이트 및 앱 전환 위치를 사용하는 경우 광고에서 applink_treatment이 web_only로 설정된 크리에이티브를 사용할 수 없습니다. 이 제한은 2026년 10월 27일부터 모든 마케팅 API 버전에 적용됩니다.
마케팅 API - Messenger 스토리: 2026년 7월 29일부터 버전이 지정된 v26.0 이상의 호출에서 광고 세트를 만들거나 업데이트할 때 messenger_positions에서 story 값이 자동으로 삭제됩니다. 사용 중단은 버전이 지정되지 않은 호출을 포함하여 모든 마케팅 API 버전에 대해 2026년 10월 27일부터 적용됩니다.
마케팅 API - 설문 광고 만들기: 2026년 7월 29일부터 v26.0 이상에서 설문 크리에이티브를 만들거나 이를 사용하기 위해 광고를 변경하는 요청은 거부됩니다. 크리에이티브를 변경하지 않는 기존 광고 업데이트는 계속 지원됩니다. 사용 중단은 2026년 10월 27일부터 모든 마케팅 API 버전에 적용됩니다.
그래프 API 및 마케팅 API - 게재 추산치 필드: daily_outcomes_curve, budget_guardrail, estimate_dau 응답 필드는 2026년 7월 29일부터 v26.0 호출에서 삭제되며, 2026년 10월 27일에는 지원되는 모든 버전에서 삭제됩니다. 대체 API를 사용할 수 없습니다.
그래프 API 버전 지원 중단: 그래프 API v20.0은 2026년 9월 24일에 사용 중단되고 삭제됩니다. 그래프 API v21.0은 2027년 1월 21일에 사용 중단 및 삭제됩니다.

일반 업데이트

마케팅 API: WhatsApp 상태 지원 광고 확장

2026년 7월 29일부터 마케팅 API v26.0 이상에서 WhatsApp 상태 광고가 추가적인 ID, 타게팅, 최적화, 크리에이티브 기능을 지원합니다.

WhatsApp ID: 타사 마케팅 API 호출자가 WhatsApp 상태 게재용 광고 크리에이티브에 wamo_whatsapp_identity_spec을 명시적으로 포함해야 합니다. 이러한 발신자의 경우 WhatsApp ID가 자동으로 기본 설정되지 않습니다.
알 수 없는 연령 타게팅: WhatsApp 상태 노출 위치를 선택하고 user_age_unknown을 설정하지 않으면 해당 필드가 기본적으로 true로 설정됩니다. 이로 인해 캠페인이 WhatsApp에서 연령을 알 수 없는 사람들에게 도달할 수 있게 됩니다.
최적화: 판매, 잠재 고객 및 참여 목표 전반에서 오프사이트 전환에 대한 전환 최적화가 지원됩니다. 랜딩 페이지 조회 최적화도 지원됩니다.
크리에이티브 형식: 슬라이드 광고는 최대 10개의 슬라이드를 지원합니다.

자세한 내용은 노출 위치 타게팅 및 기본 타게팅 문서를 참조하세요.

사용 중단 및 핵심 변경 사항

그래프 API 및 마케팅 API: 게재 추산치 필드 삭제

이러한 값을 제공하는 서비스가 사용 중단되어 daily_outcomes_curve, budget_guardrail, estimate_dau 필드가 게재 추산치 엔드포인트 응답에서 삭제됩니다. 2026년 7월 29일부터 그래프 API v26.0 및 마케팅 API v26.0 이상에서는 이러한 필드가 더 이상 반환되지 않습니다. 이 변경 사항은 2026년 10월 27일부터 남아 있는 모든 지원되는 그래프 API 및 마케팅 API 버전에 적용됩니다. 대체 API를 사용할 수 없습니다.

개발자는 해당 삭제 날짜 이전에 이러한 필드의 사용이나 참조를 삭제해야 합니다.

영향을 받는 대표적인 엔드포인트는 다음과 같습니다.

GET /{ad-account-id}/delivery_estimate - 광고 계정 게재 추산치
GET /{adset-id}/delivery_estimate - 광고 세트 게재 추산치

전체 필드 및 엔드포인트 리스트는 V26.0 변경 사항에서 확인할 수 있습니다.

그래프 API: 커머스 주문 관리 API 사용 중단

2026년 7월 29일부터 그래프 API v26.0 이상에서 이러한 엔드포인트를 호출하는 앱이 차단됩니다. 2026년 10월 27일부터 나머지 모든 그래프 API 버전의 엔드포인트가 삭제되며 이후에는 호출 시 오류가 반환됩니다.

Facebook 및 Instagram에서 직접 결제할 수 있는 Shops 환경이 완전히 사용 중단되었습니다. 커머스 주문 관리 API를 통해 타사 플랫폼에서 해당 결제 환경에 대한 주문을 등록하고, 주문 상세 정보를 보고, 배송을 관리하고, 취소를 처리하고, 반품을 처리하고, 반품을 추적할 수 있었습니다. 기본 커머스 주문 인프라가 중단될 예정이므로 이러한 엔드포인트가 사용 중단됩니다.

개발자는 이러한 엔드포인트 호출을 중단하고 종속성을 삭제해야 합니다. 대체 API를 사용할 수 없습니다.

영향을 받는 대표적인 엔드포인트는 다음과 같습니다.

GET /{commerce-order-id} - 주문 상세 정보
GET /{commerce-order-id}/items - 주문 품목
GET /{commerce-order-id}/payments - 주문 결제
GET /{commerce-order-id}/payment_transaction_details - 결제 거래 상세 정보
GET /{commerce-order-id}/refunds - 주문 환불
GET /{commerce-order-id}/shipments - 주문 배송
GET /{commerce-order-shipment-id}/items - 배송 품목
GET /{commerce-return-id} - 반품 대상 제품 정보
GET /{commerce-order-cancellation-id}/items - 취소 품목
GET /{page-id}/commerce_orders - 페이지별로 주문 리스트 표시
GET /{commerce-merchant-settings-id}/commerce_orders - 커머스 판매자 설정을 기준으로 주문 나열
GET /{commerce-merchant-settings-id}/commerce_returns - 커머스 판매자 설정별 반품 리스트
GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

영향을 받게 되는 47개의 엔드포인트에 대한 전체 리스트는 그래프 API v26.0 변경 사항에서 확인할 수 있습니다.

그래프 API: 권한 관리자 소유자 필드가 RightsHolderOwner로 마이그레이션됨

AudioVisualReferenceMatch 및 ImageReferenceMatch의 reference_owner 및 matched_reference_owner 필드와 CopyrightOwnershipTransfer의 sending_rights_holder 및 receiving_rights_holder 필드가 사용 중단됩니다. 그래프 API v26.0부터는 권한 관리자가 사용하는 소유권 모델을 더욱 정확하게 나타낼 수 있도록 전용 RightsHolderOwner 유형을 반환하는 대체 필드를 사용할 수 있으며, 사용 중단된 필드는 v26.0 이후의 응답에서 더 이상 반환되지 않습니다.

사용 중단되는 필드는 v26.0 출시 후 2년간 v25.0 이전 버전에서 계속 작동하며, 그 후에는 삭제됩니다. 개발자는 이 2년의 기간 동안 대체 필드로 마이그레이션해야 합니다.

다음 대체 필드를 사용하세요.

reference_owner 대신 reference_owner_rh_owner을 사용하세요.
matched_reference_owner 대신 matched_reference_owner_rh_owner을 사용하세요.
sending_rights_holder 대신 sending_rights_holder_owner을 사용하세요.
receiving_rights_holder 대신 receiving_rights_holder_owner를 사용하세요.

영향을 받는 대표적인 엔드포인트는 다음과 같습니다.

GET /{audio-visual-reference-match-id} - 참조 일치 세부 정보
GET /{image-reference-match-id} - 이미지 참조 일치 상세 정보
GET /{copyright-ownership-transfer-id} - 소유권 이전 상세 정보

전체 필드 리스트는 그래프 API v26.0 변경 사항에서 확인할 수 있습니다.

그래프 API: 기존 프로토콜 기능 사용 중단

2026년 7월 29일부터 그래프 API v26.0 이상에서는 더 이상 pretty, debug, date_format, root GET /?ids=... 요청, 기존 If-None-Match / ETag 처리 등 5가지 기존 프로토콜 동작이 지원되지 않습니다.

이러한 동작은 그래프 API 응답을 단순화하고 요청 처리를 더욱 일관적으로 만들기 위해 중단됩니다.

그래프 API v26.0 이상의 경우:

pretty은 무시되며, JSON 응답은 컴팩트 형식을 사용합니다. 클라이언트 도구 또는 코드에서 JSON 형식을 지정합니다.
debug은(는) 무시되고 디버그 응답 봉투가 추가되지 않습니다. 표준 디버깅 도구를 사용합니다. debug_token 엔드포인트는 영향을 받지 않습니다.
date_format을 포함하는 요청은 매개변수 오류를 반환합니다. 기본 날짜 형식을 사용하고 필요한 경우 로컬로 값을 변환하세요.
GET /?ids=...을 사용하는 루트 요청은 매개변수 오류를 반환합니다. 개체별 요청 또는 지원되는 일괄 처리 기능을 사용합니다.
If-None-Match은(는) 무시됩니다. 레거시 ETag 응답 헤더 및 304 Not Modified 동작이 삭제되고 요청이 전체 응답을 반환합니다.

2026년 10월 27일부터 지원되는 모든 나머지 그래프 API 버전에 이러한 변경 사항이 적용됩니다. 마이그레이션 상세 정보를 알아보려면 런타임 요청 로그와 그래프 API v26.0 변경 사항을 검토하세요.

새로운 페이지 환경을 위한 기존 페이지 필드 사용 중단(그래프 API v26.0)

개발자 블로그 게시물 임시 저장본. 타겟 릴리스: 그래프 API v26.0. 변경 유형: 사용 중단(90일).

요약

새로운 페이지 경험 페이지의 경우, 기존 페이지 노드 필드 5개(current_location, genre, network, parking, start_info)와 auto_publish_page_info_updates 페이지 설정이 그래프 API v26.0부터 지원 중단됩니다. 이 필드는 더 이상 유지 관리되지 않으며 새로운 페이지 환경 페이지에서 액세스해서는 안 됩니다.

타임라인

2026년 7월 29일: 새로운 페이지 환경 페이지의 v26.0 이상에서 필드가 차단되고 설정이 삭제됩니다.
출시 후 약 90일: 나머지 모든 버전에 동일한 변경 사항이 적용됩니다. 2026년 10월 말의 정확한 날짜는 추후 확인됩니다.

변경 사항

v26.0 이후 버전에서 새로운 페이지 환경 페이지의 5개 필드 중 하나를 요청하면 버전 오류가 반환되고 auto_publish_page_info_updates 설정이 페이지 설정 응답에 더 이상 표시되지 않습니다. 이전 버전의 경우 90일 마이그레이션 기간이 종료될 때까지 동작이 변경되지 않으며, 이후에는 모든 버전에 동일하게 적용됩니다.

영향을 받는 엔드포인트:

GET /{page-id}?fields=current_location
GET /{page-id}?fields=genre
GET /{page-id}?fields=network
GET /{page-id}?fields=parking
GET /{page-id}?fields=start_info
GET /{page-id}?fields=settings - auto_publish_page_info_updates 설정이 반환된 설정 리스트에서 삭제됩니다.

개발자가 해야 할 일

페이지 요청에서 해당 필드와 auto_publish_page_info_updates 설정을 삭제하세요.
요청 로그, 클라이언트 통합 및 대시보드에서 새로운 페이지 환경 페이지에 이 필드가 사용되었는지 확인하세요.
완전한 최신 리스트를 확인하려면 그래프 API v26.0 변경 사항을 참조하세요.

참조

페이지 노드 참고 자료

마케팅 API: 주택, 고용, 금융 상품 및 서비스 캠페인에 대한 어드밴티지+ 타겟 요구 사항

2026년 7월 29일부터 마케팅 API v26.0에서 완전히 기본값만 사용하는 타겟 설정 또는 완화된 타겟 설정에 대해 targeting_automation 내의 advantage_audience 매개변수가 자동으로 1로 기본 설정됩니다. 제한된 타겟 설정의 경우, 개발자는 주택, 고용 또는 금융 상품 및 서비스 특별 광고 카테고리의 캠페인에 대해 advantage_audience을 1 또는 0으로 설정해야 합니다.

이 동작은 새로운 광고 세트를 만드는 경우에만 적용됩니다. 기존 광고 세트를 업데이트하면 어떤 API 버전에서도 이와 같은 동작이 표시되지 않습니다.

이는 마케팅 API v23.0에서 특별 광고 카테고리가 아닌 캠페인에 도입된 것과 동일한 동작입니다. 자세한 내용은 어드밴티지+ 타겟 문제 해결 문서를 참조하세요.

다음 API 엔드포인트가 영향을 받습니다.

POST /{ad-account-id}/adsets
POST /{adset-id}
POST /{adset-id}/copies

마케팅 API: 더 이상 '둘러보기' 노출 위치 이용 불가

2026년 7월 29일부터 마케팅 API v26.0 이상에서 Instagram 탐색 탭 피드 노출 위치를 더 이상 사용할 수 없습니다. 탐색 탭에 광고가 더 이상 게재되지 않으며, 캠페인 지출이 자동으로 다른 적합한 노출 위치로 이동됩니다.

탐색 탭 노출 위치를 지정하는 광고 세트를 만들거나 업데이트하면 오류가 반환됩니다. 개발자는 노출 위치 구성에서 '둘러보기'를 삭제하고 다른 해당 노출 위치를 사용해야 합니다.

다음 엔드포인트가 영향을 받습니다.

POST /act_{ad-account-id}/adsets
POST /{ad-set-id}

마케팅 API: 웹+앱 캠페인에 대한 웹 전용 랜딩 페이지 지원 중단

2026년 7월 29일부터 마케팅 API v26.0을 통해 개발자는 웹사이트 및 앱 전환 위치를 사용하는 캠페인의 광고에 applink_treatment이 web_only로 설정된 광고 크리에이티브를 더 이상 첨부할 수 없습니다. 이는 POST /act_{ad-account-id}/ads 및 POST /{ad-id}를 통한 광고 만들기 및 업데이트에 영향을 미칩니다.

광고 크리에이티브 엔드포인트는 변경되지 않지만, POST /act_{ad-account-id}/adcreatives는 applink_treatment 값이 구성되는 위치입니다. 개발자는 applink_treatment=web_only에 대한 통합을 검토하고 자동 랜딩 페이지 선택 또는 웹사이트 및 앱 캠페인에 호환되는 다른 수동 랜딩 페이지를 사용해야 합니다.

v26.0 릴리스 후 90일이 지난 2026년 10월 27일부터 모든 마케팅 API 버전에 이 제한이 적용됩니다. 자세한 내용은 광고 및 광고 크리에이티브 문서를 참조하세요.

마케팅 API: Messenger 스토리 노출 위치 지원 중단

2026년 7월 29일부터 마케팅 API v26.0 이상에서 버전이 지정된 v26.0 이상의 호출을 통해 광고 세트를 만들거나 업데이트할 때 messenger_positions에서 story 값을 더 이상 사용할 수 없습니다.

이러한 호출에서 story은(는) 타게팅 사양에서 자동으로 삭제되며, 신규 또는 기존 광고 세트의 유효 노출 위치에 더 이상 표시되지 않습니다. GET /{ad_set-id}?fields=targeting을 통해 요청될 경우 이전 타게팅 데이터에 계속해서 story가 포함될 수도 있습니다. 전용 오류가 반환되지는 않지만 story을 삭제하면 노출 위치 구성이 유효하지 않게 되는 경우 표준 노출 위치 유효성 검사 오류가 적용될 수 있습니다.

다음 엔드포인트가 영향을 받습니다.

POST /act_{ad-account-id}/adsets
POST /{ad_set-id}

수동 노출 위치를 사용하는 개발자는 messenger_positions에서 story를 삭제해야 합니다. story가 유일한 값인 경우 전체 messenger_positions 필드를 삭제하고, marketing_messages 등의 다른 Messenger 노출 위치가 사용되지 않는다면 publisher_platforms에서 messenger를 삭제할 것을 고려하세요. 어드밴티지+ 노출 위치에 별도로 취해야 할 조치는 없습니다.

이 API 전용 변경 사항은 광고 관리자에 영향을 미치지 않습니다. 버전이 지정되지 않은 호출과 v26.0 이전 버전에 대한 호출은 처음에는 영향을 받지 않습니다. v26.0 릴리스 이후 90일이 지난 2026년 10월 27일부터 버전이 지정되지 않은 호출을 포함하여 모든 마케팅 API 버전에 사용 중단이 적용됩니다.

마케팅 API: 설문 광고 만들기 지원 중단

2026년 7월 29일부터 마케팅 API v26.0 이상에서 광고 및 광고 크리에이티브를 만들거나 업데이트할 때 설문 구성 요소가 더 이상 지원되지 않습니다. interactive_components_spec에서 type 필드의 "poll" 값 및 poll_spec 필드를 더 이상 사용할 수 없습니다.

설문 크리에이티브를 만들거나 설문 크리에이티브를 사용하도록 광고를 변경하는 요청은 거부됩니다. 상태, 예산, 일정 변경 등 크리에이티브를 변경하지 않는 기존 광고에 대한 업데이트는 계속 진행할 수 있습니다.

다음 엔드포인트가 영향을 받습니다.

개발자는 크리에이티브 사양에서 설문 관련 필드를 삭제하고 설문 구성 요소가 없는 크리에이티브를 사용해야 합니다. v26.0 이전 버전에 대한 호출과 버전이 지정되지 않은 호출은 처음에는 영향을 받지 않습니다.

v26.0 릴리스 이후 90일이 지난 2026년 10월 27일부터 모든 마케팅 API 버전에 이 사용 중단 사항이 적용됩니다.

Meta 비즈니스 SDK v26 릴리스

그래프 API v26 출시 직후 Meta 비즈니스 SDK v26가 출시될 예정입니다. 이번 릴리스는 종속성 업그레이드, 전환 API 매개변수 빌드 도구 통합, 새로운 API 기능, 커머스 주문 관리 API 및 여러 기존 프로토콜 기능의 사용 중단을 포함합니다.

비즈니스 SDK가 오픈 소스 전환 API 매개변수 빌드 도구와 통합되었습니다. 이 새로운 통합을 활용하여 전환 API 통합의 품질을 개선할 수 있습니다. 주요 기능: fbc, fbp, event_source_url, referrer_url, client_ip_address 매개변수 및 지원되는 언어에 대한 자동 PII 정규화/해싱을 자동 생성(광고주가 설정한 기본 설정으로 제한)하고 개선합니다. 여기에서 자세히 알아보세요. 커머스 주문 관리 API(엔드포인트 47개)는 대체 없이 완전히 사용 중단됩니다. Instagram 탐색 탭 피드 광고 노출 위치는 삭제되었으며 지정하면 오류가 반환됩니다. Messenger 스토리 노출 위치는 messenger_positions에서 자동으로 삭제됩니다. WhatsApp 상태 광고에 ID 사양, 최대 10개의 슬라이드, 오프사이트 전환 최적화 등 새로운 기능이 추가되었습니다.

플랫폼 SDK의 2년 사용 중단 일정에 따른 향후 사용 중단 및 버전 중단 소식을 참조하세요.