<?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;
/*****
* 本文件提供了一个获取商品库报表(Product catalogs report)列表的简单示例
*/
class GetProductCatalogsReports
{
public static $tads;
public static $ACCESS_TOKEN = 'YOUR ACCESS TOKEN';
public static $ACCOUNT_ID = 'YOUR ACCOUNT ID';
public static $PRODUCT_CATALOG_ID = 'YOUR PRODUCT CATALOG ID'; // 商品库ID
public static $START_DATE = 'REPORT START DATE'; // 报表开始日期
public static $END_DATE = 'REPORT END DATE'; // 报表结束日期
public function init()
{
$tads = TencentAds::init([
'access_token' => static::$ACCESS_TOKEN,
'is_debug' => true,
]);
$tads->useSandbox(); // 默认访问沙箱环境,如访问正式环境,请切换为$tads->useProduction()
static::$tads = $tads;
return $tads;
}
public function main()
{
try {
/* @var TencentAds $tads */
$tads = static::$tads;
$fields = [
'date', 'product_catalog_id', 'product_outer_id', 'view_count', 'valid_click_count', 'ctr', 'cpc',
'cost',
]; // 需要返回的字段
$response = $tads->productCatalogsReports()
->get([
'account_id' => static::$ACCOUNT_ID,
'product_catalog_id' => static::$PRODUCT_CATALOG_ID,
'date_range' => [
'start_date' => static::$START_DATE,
'end_date' => static::$END_DATE,
],
'fields' => $fields,
]);
// 从返回里获得Report信息
foreach ($response->getList() as $report) {
// echo $report . PHP_EOL;
}
return $response;
} catch (TencentAdsResponseException $e) {
// When Api returns an error
echo 'Tencent ads returned an error: ' . $e->getMessage() . PHP_EOL;
throw $e;
} catch (TencentAdsSDKException $e) {
// When validation fails or other local issues
echo 'Tencent ads SDK returned an error: ' . $e->getMessage() . PHP_EOL;
throw $e;
} catch (Exception $e) {
echo 'Other exception: ' . $e->getMessage() . PHP_EOL;
throw $e;
}
}
}
if (basename($_SERVER['PHP_SELF']) == basename(__FILE__)) {
try {
$example = new GetProductCatalogsReports();
$example->init();
$example->main();
} catch (\Exception $e) {
exit(-1);
}
}
package com.tencent.ads.examples.BasicOperations.Insights;
import com.tencent.ads.ApiContextConfig;
import com.tencent.ads.TencentAds;
import com.tencent.ads.exception.TencentAdsResponseException;
import com.tencent.ads.exception.TencentAdsSDKException;
import com.tencent.ads.model.*;
import com.tencent.ads.model.FilteringStruct;
import com.tencent.ads.model.OrderByStruct;
import com.tencent.ads.model.ReportDateRange;
import java.util.Arrays;
import java.util.List;
public class GetProductCatalogsReports {
/** YOUR ACCESS TOKEN */
public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";
/** TencentAds */
public TencentAds tencentAds;
public Long accountId = null;
public Long productCatalogId = null;
public ReportDateRange dateRange = new ReportDateRange();
public List<FilteringStruct> filtering = null;
public List<String> groupBy = null;
public List<OrderByStruct> orderBy = null;
public List<String> fields =
Arrays.asList(
"date",
"product_catalog_id",
"product_outer_id",
"view_count",
"valid_click_count",
"ctr",
"cpc",
"cost");
public void init() {
this.tencentAds = TencentAds.getInstance();
this.tencentAds.init(
new ApiContextConfig().accessToken(ACCESS_TOKEN).isDebug(true)); // debug==true 会打印请求详细信息
this.buildParams();
}
public void buildParams() {
String startDate = "REPORT START DATE";
dateRange.setStartDate(startDate);
String endDate = "REPORT END DATE";
dateRange.setEndDate(endDate);
}
public ProductCatalogsReportsGetResponseData getProductCatalogsReports() throws Exception {
ProductCatalogsReportsGetResponseData response =
tencentAds
.productCatalogsReports()
.productCatalogsReportsGet(
accountId, productCatalogId, dateRange, filtering, groupBy, orderBy, fields);
return response;
}
public static void main(String[] args) {
try {
GetProductCatalogsReports getProductCatalogsReports = new GetProductCatalogsReports();
getProductCatalogsReports.init();
ProductCatalogsReportsGetResponseData response =
getProductCatalogsReports.getProductCatalogsReports();
} catch (TencentAdsResponseException e) {
e.printStackTrace();
} catch (TencentAdsSDKException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
}
/*
* Marketing API
*
* Marketing API
*
* API version: 1.3
* Generated by: Swagger Codegen (https://github.com/swagger-api/swagger-codegen.git)
*/
package main
import (
"encoding/json"
"fmt"
"net/http"
"github.com/antihax/optional"
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/api"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
"github.com/tencentad/marketing-api-go-sdk/pkg/errors"
"github.com/tencentad/marketing-api-go-sdk/pkg/model"
)
type ProductCatalogsReportsGetExample struct {
TAds *ads.SDKClient
AccessToken string
AccountId int64
ProductCatalogId int64
DateRange model.ReportDateRange
ProductCatalogsReportsGetOpts *api.ProductCatalogsReportsGetOpts
}
func (e *ProductCatalogsReportsGetExample) Init() {
e.AccessToken = "YOUR ACCESS TOKEN"
e.TAds = ads.Init(&config.SDKConfig{
AccessToken: e.AccessToken,
IsDebug: true,
})
e.AccountId = int64(0)
e.ProductCatalogId = int64(0)
e.DateRange = model.ReportDateRange{
StartDate: "REPORT START DATE",
EndDate: "REPORT END DATE",
}
e.ProductCatalogsReportsGetOpts = &api.ProductCatalogsReportsGetOpts{
Fields: optional.NewInterface([]string{"date", "product_catalog_id", "product_outer_id", "view_count", "valid_click_count", "ctr", "cpc", "cost"}),
}
}
func (e *ProductCatalogsReportsGetExample) RunExample() (model.ProductCatalogsReportsGetResponseData, http.Header, error) {
tads := e.TAds
// change ctx as needed
ctx := *tads.Ctx
return tads.ProductCatalogsReports().Get(ctx, e.AccountId, e.ProductCatalogId, e.DateRange, e.ProductCatalogsReportsGetOpts)
}
func main() {
e := &ProductCatalogsReportsGetExample{}
e.Init()
response, headers, err := e.RunExample()
if err != nil {
if resErr, ok := err.(errors.ResponseError); ok {
errStr, _ := json.Marshal(resErr)
fmt.Println("Response error:", string(errStr))
} else {
fmt.Println("Error:", err)
}
}
fmt.Println("Response data:", response)
fmt.Println("Headers:", headers)
}