GET Lấy danh sách hiệu suất video của Shop
Lấy danh sách hiệu suất video của Shop Shop Scope yêu cầu: data.shop_analytics.public.read Trả về danh sách video và các chỉ số liên quan của một shop. Phiên bản 202605
GET/analytics/202605/shop_videos/performance
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key riêng. 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ể nhận diện 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 để chuyển đổi sang giờ địa phương. |
| start_date_ge Required | string | Ngày bắt đầu (định dạng ISO 8601 YYYY-MM-DD) theo múi giờ đăng ký của shop.Trong tên tham số, "ge" nghĩa là "lớn hơn hoặc bằng" (bao gồm) |
| end_date_lt Required | string | Ngày kết thúc (định dạng ISO 8601 YYYY-MM-DD) theo múi giờ đăng ký của shop.Trong tên tham số, "lt" nghĩa là "nhỏ hơn" (không bao gồm) |
| page_size | int | Số sản phẩm trên mỗi trang.Giá trị tối đa: 100Giá trị mặc định: 10 |
| sort_field | string | Trường sắp xếp.Giá trị mặc định: gmvCác giá trị có sẵn: - gmv- gpm- avg_customers- sku_orders- items_sold- views- click_through_rate |
| sort_order | string | Hướng sắp xếp.Các giá trị có sẵn: ASC, DESCGiá trị mặc định: DESC* ASC: tăng dần* DESC: giảm dần |
| currency | string | Đơn vị tiền tệ.Các giá trị có sẵn: USD, LOCALGiá trị mặc định: LOCAL* USD: đô la Mỹ* LOCAL: đơn vị tiền tệ địa phương nơi shop đặt trụ sở |
| page_token | string | Page token, cho biết vị trí hiện tại. Được dùng để yêu cầu dữ liệu trang tiếp theo.Để trống trường này cho lần truy vấn đầu tiên. |
| account_type | string | Các loại tài khoản mà video được tạo ra.Các giá trị có sẵn: ALL, OFFICIAL_ACCOUNTS, MARKETING_ACCOUNTS, AFFILIATE_ACCOUNTSGiá trị mặc định: ALL- ALL: tất cả các loại tài khoản- OFFICIAL_ACCOUNTS,- MARKETING_ACCOUNTS,- AFFILIATE_ACCOUNTS |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
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 thông báo. |
| 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 thường gặp
| Code | Message | | --- | --- | | 28001022 | invalid request params; detail: start time or end time is invalid. | | 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