Tổng quan

API Marketing là API dựa trên HTTP mà bạn có thể dùng để truy vấn dữ liệu, tạo cũng như quản lý quảng cáo và thực hiện nhiều tác vụ khác theo lập trình. Phần này trình bày thông tin chung về API Marketing, quyền truy cập, lập phiên bản và hơn thế nữa.

Vì dựa trên HTTP nên API này hoạt động với bất kỳ ngôn ngữ hoặc phần mềm nào hỗ trợ HTTP, bao gồm cả cURL và hầu hết mọi trình duyệt web hiện đại. API Marketing được xây dựng dựa trên API Đồ thị của Meta. Do đó, hầu hết mọi yêu cầu đều được chuyển cho URL lưu trữ graph.facebook.com.

Khái niệm cơ bản

Các khái niệm bạn cần hiểu rõ để sử dụng API Marketing:

Cấu trúc chiến dịch quảng cáo

Meta sắp xếp quảng cáo theo cấu trúc có 3 cấp độ: chiến dịch, nhóm quảng cáo và quảng cáo. Trong API, nhà phát triển có quyền truy cập vào cấp độ thứ tư là nội dung.

Ủy quyền

Để truy cập các điểm cuối API Marketing, ứng dụng của bạn phải vượt qua nhiều lớp của quá trình ủy quyền API Đồ thị.

Xác thực

Tìm hiểu cách nhận và lưu trữ mã truy cập cần dùng cho lệnh gọi API.

Giới hạn tốc độ

API Marketing có logic giới hạn tốc độ riêng và được loại trừ khỏi tất cả các giới hạn tốc độ API Đồ thị.

Lập phiên bản

Nền tảng của Meta có mô hình lập phiên bản cốt lõi và mở rộng. Tìm hiểu thêm về các thay đổi sắp tới và tính năng không dùng nữa bằng cách sử dụng hệ thống lập phiên bản và chuyển của chúng tôi. Hãy xem phần Lịch trình phiên bản, Hoạt động chuyển và Nhật ký thay đổi.

Xét duyệt ứng dụng

Để sử dụng API Marketing, ứng dụng của bạn phải trải qua quy trình Xét duyệt ứng dụng, ngoại trừ một số trường hợp Chuyển đổi offline và API phía máy chủ.

Quyền

Có 2 quyền chính đối với quảng cáo, đó là ads_management và ads_read. Bạn nên cấp quyền cho ứng dụng mà bạn dùng để thực hiện lệnh gọi. Bạn có thể yêu cầu cấp quyền trong quy trình xét duyệt ứng dụng. Hãy xem danh sách các quyền hiện có cho Ứng dụng dành cho doanh nghiệp.

Mã lỗi

Bạn có thể thấy mã lỗi khi đang dùng API. Hãy tham khảo nội dung này để tìm hiểu thêm về từng mã lỗi.

Hậu xử lý

Tìm hiểu giai đoạn hậu xử lý sau khi Meta nhận được một yêu cầu.