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

/*****
 * 本文件提供了一个创建人群授权(Audience grant relation)的简单示例
 */
class AddAudienceGrantRelations
{
    public static $tads;
    public static $ACCESS_TOKEN          = 'YOUR ACCESS TOKEN';
    public static $ACCOUNT_ID            = 'YOUR ACCOUNT ID';
    public static $AUDIENCE_ID           = 'YOUR AUDIENCE ID'; // 人群ID
    public static $GRANT_SCOPE_TYPE      = 'GRANT_SCOPE_TYPE_BUSINESS'; // 人群授权给商务管家账号认领的所有广告账号
    public static $GRANT_PERMISSION_TYPE = 'GRANT_PERMISSION_TYPE_TARGET'; // 广告投放权限
    public static $GRANT_BUSINESS_ID     = 'YOUR BUSINESS ID'; // 商务管家账号

    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;

            $grantSpec = [
                'grant_to_business_spec' => [
                    'grant_business_id'         => static::$GRANT_BUSINESS_ID,
                    'grant_scope_type'          => static::$GRANT_SCOPE_TYPE,
                    'grant_business_permission' => [
                        'grant_permission_type_list' => [static::$GRANT_PERMISSION_TYPE],
                    ],
                ],
            ];

            $response = $tads->audienceGrantRelations()
                             ->add([
                                 'account_id'       => static::$ACCOUNT_ID,
                                 'audience_id_list' => [static::$AUDIENCE_ID],
                                 'grant_type'       => 'GRANT_TYPE_BUSINESS',
                                 'grant_spec'       => $grantSpec,
                             ]);

            return true;
        } 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 AddAudienceGrantRelations();
        $example->init();
        $example->main();
    } catch (\Exception $e) {
        exit(-1);
    }
}
            

                package com.tencent.ads.examples.BasicOperations.AudiencesManagement;

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.AudienceGrantRelationsAddRequest;
import com.tencent.ads.model.AudienceGrantRelationsAddResponse;
import java.util.Arrays;
import java.util.List;

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

  /** TencentAds */
  public TencentAds tencentAds;

  public Long accountId = null;
  public AudienceGrantRelationsAddRequest data = new AudienceGrantRelationsAddRequest();
  public AudienceGrantType grantType = AudienceGrantType.GRANT_TYPE_BUSINESS;
  public Long grantBusinessId = null;
  public AudienceGrantScopeType grantScopeType = AudienceGrantScopeType.BUSINESS;
  public List<String> grantPermissionTypeList = Arrays.asList("GRANT_PERMISSION_TYPE_TARGET");
  public List<Long> audienceIdList = Arrays.asList(0L);

  public void init() {
    this.tencentAds = TencentAds.getInstance();
    this.tencentAds.init(
        new ApiContextConfig().accessToken(ACCESS_TOKEN).isDebug(true)); // debug==true 会打印请求详细信息

    this.buildParams();
  }

  public void buildParams() {
    data.setAccountId(accountId);

    data.setGrantType(grantType);

    AudienceGrantRelationsAddGrantToBusinessSpec grantToBusinessSpec =
        new AudienceGrantRelationsAddGrantToBusinessSpec();
    grantToBusinessSpec.setGrantBusinessId(grantBusinessId);
    grantToBusinessSpec.setGrantScopeType(grantScopeType);
    GrantBusinessPermission grantBusinessPermission = new GrantBusinessPermission();
    grantBusinessPermission.setGrantPermissionTypeList(grantPermissionTypeList);
    grantToBusinessSpec.setGrantBusinessPermission(grantBusinessPermission);
    AudienceGrantRelationsAddGrantSpec grantSpec = new AudienceGrantRelationsAddGrantSpec();
    grantSpec.setGrantToBusinessSpec(grantToBusinessSpec);
    data.setGrantSpec(grantSpec);

    data.setAudienceIdList(audienceIdList);
  }

  public AudienceGrantRelationsAddResponse addAudienceGrantRelations() throws Exception {
    AudienceGrantRelationsAddResponse response =
        tencentAds.audienceGrantRelations().audienceGrantRelationsAdd(data);
    return response;
  }

  public static void main(String[] args) {
    try {
      AddAudienceGrantRelations addAudienceGrantRelations = new AddAudienceGrantRelations();
      addAudienceGrantRelations.init();
      AudienceGrantRelationsAddResponse response =
          addAudienceGrantRelations.addAudienceGrantRelations();
    } 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/config"
	"github.com/tencentad/marketing-api-go-sdk/pkg/errors"
	"github.com/tencentad/marketing-api-go-sdk/pkg/model"
)

type AudienceGrantRelationsAddExample struct {
	TAds        *ads.SDKClient
	AccessToken string
	Data        model.AudienceGrantRelationsAddRequest
}

func (e *AudienceGrantRelationsAddExample) Init() {
	e.AccessToken = "YOUR ACCESS TOKEN"
	e.TAds = ads.Init(&config.SDKConfig{
		AccessToken: e.AccessToken,
		IsDebug:     true,
	})
	e.Data = model.AudienceGrantRelationsAddRequest{
		AccountId: int64(0),
		GrantType: model.AudienceGrantType_GRANT_TYPE_BUSINESS,
		GrantSpec: &model.AudienceGrantRelationsAddGrantSpec{
			GrantToBusinessSpec: &model.AudienceGrantRelationsAddGrantToBusinessSpec{
				GrantBusinessId: int64(0),
				GrantScopeType:  model.AudienceGrantScopeType_BUSINESS,
				GrantBusinessPermission: &model.GrantBusinessPermission{
					GrantPermissionTypeList: &[]string{"GRANT_PERMISSION_TYPE_TARGET"},
				},
			},
		},
		AudienceIdList: &[]int64{int64(0)},
	}
}

func (e *AudienceGrantRelationsAddExample) RunExample() (interface{}, http.Header, error) {
	tads := e.TAds
	// change ctx as needed
	ctx := *tads.Ctx
	return tads.AudienceGrantRelations().Add(ctx, e.Data)
}

func main() {
	e := &AudienceGrantRelationsAddExample{}
	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)
}