旧版投放(即将下线)
接口文档SDK业务专题开发者工具

附近推 - 附近推门店

SDK使用指南如何授权账号管理营销资产广告管理创意工具数据洞察人群管理数据上报附近推
附近推开户 附近推账户资金 附近推账户资质 附近推广告投放 附近推门店
审核工具投放辅助工具分场景接口应用

搜索门店

                <?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;

/*****
 * 本文件提供了一个搜索附近推门店(Local stores)的简单示例
 */
class GetLocalStoresSearchInfo
{
    public static $tads;
    public static $ACCESS_TOKEN = 'YOUR ACCESS TOKEN';
    public static $ACCOUNT_ID   = 'YOUR ACCOUNT ID';
    public static $KEY_WORD     = 'YOUR KEYWORD'; // 关键词

    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;

            $response = $tads->localStoresSearchInfo()
                             ->get([
                                 'account_id' => static::$ACCOUNT_ID,
                                 'key_word'   => static::$KEY_WORD,
                             ]);

            // 从返回里获得Local store信息
            foreach ($response->getList() as $store) {
                // echo $store . 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 GetLocalStoresSearchInfo();
        $example->init();
        $example->main();
    } catch (\Exception $e) {
        exit(-1);
    }
}
            
                package com.tencent.ads.examples.BasicOperations.LocalBusiness;

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 java.util.List;

public class GetLocalStoresSearchInfo {
  /** YOUR ACCESS TOKEN */
  public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";

  /** TencentAds */
  public TencentAds tencentAds;

  public Long accountId = null;

  public String keyWord = null;

  public Long page = null;

  public Long pageSize = null;

  public List<String> fields = null;

  public void init() {
    this.tencentAds = TencentAds.getInstance();
    this.tencentAds.init(
        new ApiContextConfig().accessToken(ACCESS_TOKEN).isDebug(true)); // debug==true 会打印请求详细信息
    this.tencentAds.useSandbox(); // 默认使用沙箱环境，如果要请求线上，这里需要设为线上环境
    this.buildParams();
  }

  public void buildParams() {}

  public LocalStoresSearchInfoGetResponseData getLocalStoresSearchInfo() throws Exception {
    LocalStoresSearchInfoGetResponseData response =
        tencentAds
            .localStoresSearchInfo()
            .localStoresSearchInfoGet(accountId, keyWord, page, pageSize, fields);
    return response;
  }

  public static void main(String[] args) {
    try {
      GetLocalStoresSearchInfo getLocalStoresSearchInfo = new GetLocalStoresSearchInfo();
      getLocalStoresSearchInfo.init();
      LocalStoresSearchInfoGetResponseData response =
          getLocalStoresSearchInfo.getLocalStoresSearchInfo();
    } 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/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 LocalStoresSearchInfoGetExample struct {
	TAds                         *ads.SDKClient
	AccessToken                  string
	AccountId                    int64
	KeyWord                      string
	LocalStoresSearchInfoGetOpts *api.LocalStoresSearchInfoGetOpts
}

func (e *LocalStoresSearchInfoGetExample) Init() {
	e.AccessToken = "YOUR ACCESS TOKEN"
	e.TAds = ads.Init(&config.SDKConfig{
		AccessToken: e.AccessToken,
		IsDebug:     true,
	})
	e.AccountId = 789
	e.KeyWord = "keyWord_example"
	e.LocalStoresSearchInfoGetOpts = &api.LocalStoresSearchInfoGetOpts{}
}

func (e *LocalStoresSearchInfoGetExample) RunExample() (model.LocalStoresSearchInfoGetResponseData, http.Header, error) {
	tads := e.TAds
	// change ctx as needed
	ctx := *tads.Ctx
	return tads.LocalStoresSearchInfo().Get(ctx, e.AccountId, e.KeyWord, e.LocalStoresSearchInfoGetOpts)
}

func main() {
	e := &LocalStoresSearchInfoGetExample{}
	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)
}
复制代码
<?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;

/*****
 * 本文件提供了一个搜索附近推门店(Local stores)的简单示例
 */
class GetLocalStoresSearchInfo
{
    public static $tads;
    public static $ACCESS_TOKEN = 'YOUR ACCESS TOKEN';
    public static $ACCOUNT_ID   = 'YOUR ACCOUNT ID';
    public static $KEY_WORD     = 'YOUR KEYWORD'; // 关键词

    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;

            $response = $tads->localStoresSearchInfo()
                             ->get([
                                 'account_id' => static::$ACCOUNT_ID,
                                 'key_word'   => static::$KEY_WORD,
                             ]);

            // 从返回里获得Local store信息
            foreach ($response->getList() as $store) {
                // echo $store . 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 GetLocalStoresSearchInfo();
        $example->init();
        $example->main();
    } catch (\Exception $e) {
        exit(-1);
    }
}

广告资源

广告技术

开发文档

辅助工具

帮助支持

手机浏览开发者官网

Copyright © 1998 - 2025 Tencent Inc. All Rights Reserved.

  • 新版投放 3.0

  • 旧版投放(即将下线)