POST Chỉnh sửa chiến dịch Affiliate Partner
Chỉnh sửa chiến dịch Affiliate Partner Asset Scope bắt buộc: partner.tap_campaign.write API này cung cấp khả năng chỉnh sửa một chiến dịch Affiliate Partner. Không thể chỉnh sửa sau khi chiến dịch đã đóng. Phiên bản 202405
POST/affiliate_partner/202405/campaigns/{campaign_id}/partial_edit
Request
Path
| Properties | Type | Description |
|---|---|---|
| campaign_id Required | string | ID của chiến dịch. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại đượ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 các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng giá trị này để 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] (https://partner.tiktokshop.com/docv2/page/666012dd609d4402cc3be995). |
Body
| Properties | Type | Description |
|---|---|---|
| name | string | Tên chiến dịch. Tên chiến dịch phải ít hơn 50 ký tự. |
| description | string | Mô tả chiến dịch. Mô tả chiến dịch phải ít hơn 1000 ký tự. |
| campaign_start_time | int | Thời gian bắt đầu được lên lịch ở định dạng Unix epoch time cho chiến dịch. Lưu ý rằng trường này chỉ có thể được cập nhật khi trạng thái chiến dịch được đặt là READY hoặc UPCOMING. |
| campaign_end_time | int | Thời gian kết thúc được lên lịch ở định dạng Unix epoch time cho chiến dịch. Lưu ý rằng thời gian kết thúc phải ít hơn 360 ngày kể từ ngày bắt đầu. Trường này không còn chỉnh sửa được khi trạng thái chiến dịch được đặt là CLOSED. |
| registration_start_time | int | Thời gian bắt đầu được lên lịch ở định dạng Unix epoch cho việc đăng ký sản phẩm của seller. Lưu ý rằng trường này chỉ có thể được cập nhật khi trạng thái chiến dịch được đặt là READY hoặc UPCOMING. |
| registration_end_time | int | Thời gian kết thúc được lên lịch ở định dạng Unix epoch time cho việc đăng ký sản phẩm của seller. Trường này không còn chỉnh sửa được khi trạng thái chiến dịch được đặt là CLOSED. |
| commission_rate | int | Tổng tỷ lệ hoa hồng theo đơn vị phần trăm hàng trăm (0.01%) do affiliate partner đề xuất để hiển thị cho seller. Tỷ lệ hoa hồng phải lớn hơn 100 và nhỏ hơn 8000. |
| contact_info | object | Thông tin liên hệ của partner. |
| target_shop_codes | []string | Danh sách các shop code của seller TikTok Shop được phép đăng ký cho chiến dịch. Shop code của seller có sẵn trong TikTok Shop Seller Central bằng cách nhấp vào biểu tượng Seller Profile ở góc trên bên phải của giao diện người dùng. Danh sách phải có độ dài ít hơn 100 mục. |
| target_seller_types | []string | Danh sách các loại seller đủ điều kiện được phép đăng ký cho chiến dịch. Sử dụng trường này để nhắm mục tiêu rộng đến các loại seller thay vì các seller cụ thể trong trường target_shop_codes. Đây là kiểu liệt kê với các giá trị có thể có:- LOCAL- CROSS_BORDER |
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 | Nhật ký 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. | | 16032002 | Invalid campaign period | | 16032003 | Invalid registration period | | 16032004 | Invalid campaign seller scope | | 16032005 | Campaign not found | | 16032007 | Permission denied | | 16032008 | Operation denied |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext