GET Lấy Danh Sách Chiến Dịch Affiliate Partner
Lấy Danh Sách Chiến Dịch Affiliate Partner Asset Scope bắt buộc: partner.tap_campaign.read API này cung cấp khả năng liệt kê các chiến dịch được tạo bởi Affiliate Partner. Phiên bản 202405
GET/affiliate_partner/202405/campaigns
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị partner access_token từ Get Access Token, khi user_type = 3. Làm theo hướng dẫn này để lấy partner access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể xác định người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
| category_asset_cipher Required | string | Định danh partner được sử dụng trong các yêu cầu API. Lấy giá trị này bằng cách sử dụng Get Authorized Category Assets API. |
| page_size Required | int | Số kết quả được trả về mỗi trang. Mặc định: 10. Phạm vi hợp lệ: [1-100]. |
| page_token | string | Một token mờ được sử dụng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ kết quả của next_page_token từ phản hồi trước đó. Nó không cần thiết cho trang đầu tiên. Kích thước trang tối đa là 100 mục. |
| status | string | Trạng thái chiến dịch. Trạng thái là kiểu liệt kê với các giá trị:- READY- UPCOMING- ONGOING- CLOSED- UNSPECIFIED |
| type | string | Loại chiến dịch. Đây là kiểu liệt kê với các giá trị: - MY_CAMPAIGNS- GS_SELLING_CAMPAIGNS - SELLER_CAMPAIGNS- EXCLUSIVE_TIKTOK_SHOP Giá trị mặc định là MY_CAMPAIGNS. |
| query_type_filter | string | Một bộ lọc mở rộng được sử dụng khi thuộc tính loại chiến dịch type được đặt thành SELLER_CAMPAIGNS hoặc EXCLUSIVE_TIKTOK_SHOP. Nếu thuộc tính type được đặt thành SELLER_CAMPAIGNS, các giá trị hợp lệ cho thuộc tính này là: - MARKETPLACE: phản hồi bao gồm các chiến dịch mà partner chưa tham gia.- JOINED : phản hồi chỉ bao gồm các chiến dịch mà partner đã tham gia.Nếu thuộc tính type được đặt thành EXCLUSIVE_TIKTOK_SHOP, các giá trị hợp lệ cho thuộc tính này là:- AVAILABLE: phản hồi bao gồm các chiến dịch mà partner được phép tham gia.- JOINED: phản hồi chỉ bao gồm các chiến dịch mà partner đã tham gia.Các loại khác có thể không truyền giá trị hoặc truyền vào Default. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 16032001 | nvalid parameter Creator and Seller, please ensure Region mismatch. | | 16032007 | Permission denied | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext