v2.ams.update_basic_info_of_targeted_campaign
POST /api/v2/ams/update_basic_info_of_targeted_campaign
Edit tên chiến dịch, promotion period, message, and budget (if the shop is whitelisted) of target campaign
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/ams/update_basic_info_of_targeted_campaign
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| campaign_id | int64 | True | 101 | The unique key for the current campaign. |
| campaign_name | string | False | campaign a | Tên của the current campaign. |
| period_start_time | timestamp | False | 1735660800 | The start time of the designated campaign, tính bằng giây. |
| period_end_time | timestamp | False | 32503651199 | Thời gian kết thúc kỳ of campaign, tính bằng giây. Can set 32503651199 (2999-12-31 23:59:59) represent of no limit. |
| is_set_budget | boolean | False | true | Budget allocation toggle for the current campaign. Note: TH not supported |
| budget | float | False | 10000.0 | Budget value set for the current campaign. Note: TH not supported |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | error_business | Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. |
| message | string | Please agree to the AMS T&C in Seller Center - Affiliate Marketing Solutions first before using Open API. | Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. |
| request_id | string | b937c04e554847789cbf3fe33a0ad5f1 | Mã định danh của yêu cầu API dùng để theo dõi lỗi. |
Dữ liệu gửi
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/ams/update\_basic\_info\_of\_targeted\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp")
.header("Content-Type","application/json")
.body("{
"budget": 10000,
"campaign_id": 101,
"campaign_name": "campaign a",
"is_set_budget": true,
"period_end_time": 32503651199,
"period_start_time": 1735660800
}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/ams/update\_basic\_info\_of\_targeted\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{
"budget": 10000,
"campaign_id": 101,
"campaign_name": "campaign a",
"is_set_budget": true,
"period_end_time": 32503651199,
"period_start_time": 1735660800
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --request POST 'https://partner.shopeemobile.com/api/v2/ams/update\_basic\_info\_of\_targeted\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp'
--header 'Content-Type: application/json'
--data-raw '{
"budget": 10000,
"campaign_id": 101,
"campaign_name": "campaign a",
"is_set_budget": true,
"period_end_time": 32503651199,
"period_start_time": 1735660800
}'
import requests
import json
url = "https://partner.shopeemobile.com/api/v2/ams/update\_basic\_info\_of\_targeted\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp"
payload=json.dumps({
"budget": 10000,
"campaign_id": 101,
"campaign_name": "campaign a",
"is_set_budget": True,
"period_end_time": 32503651199,
"period_start_time": 1735660800
})
headers = {
'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)
print(response.text)