开发人员指南概述

亚马逊广告 API 概览

DSP API 教程的前提条件

本节中的每个教程都将引导您使用 DSP API 完成资源的创建、读取及更新步骤。在开始任何教程之前,您必须完成所有前提条件。

注册 DSP API

如果您尚未注册,则必须注册 DSP API,然后等待一封包含说明的电子邮件确认,以完成入门流程。如果您已注册,请记下您的客户端标识符和客户端密钥。

获取安全标识符值

亚马逊广告 API 使用 Amazon Identity Provider 对请求进行身份验证和授权。这种安全方案在所有亚马逊广告产品中保持一致。

亚马逊广告 API 要求每个请求必须包含三个标头:

Amazon-Advertising-API-ClientId 标头包含您在亚马逊广告 API 平台上注册的客户端标识符。它代表您的应用程序的唯一身份。此值不应与其他任何人共享,因为它代表您使用亚马逊广告 API 的权利。

Amazon-Advertising-API-Scope 标头包含您实体的配置文件标识符。您可以使用配置文件资源检索此标识符。

Authorization 标头是包含 OAuth 访问令牌的行业标准标头。遵循以下格式: Authorization: Bearer <access_token>

如需进一步了解如何创建授权令牌,请参阅创建 API 授权和刷新令牌

获取亚马逊 DSP API 广告主标识符

本组教程中的一些 DSP API 资源需要广告主标识符作为参数。如需获取与您的亚马逊 DSP API 账户关联的广告主标识符列表,请检索广告主资源。例如:

GET /dsp/advertisers

An example response resembles:

{
  "totalResults": 1100,
  "response": [
    {
      "advertiserId": "00000000000000",
      "name": "DSP Public API Advertiser",
      "currency": "USD",
      "url": "www.example.com",
      "country": "US",
      "timezone": "string"
    }
  ]
}

广告主标识符是 advertiserId 字段的值。

后续步骤

现在,您已经完成了所有的前提条件,接下来可以完成以下教程: