Adapters

AdMob API 能够以编程方式列出中介适配器，如需了解详情，请参阅 accounts.adSources.adapters.list。“适配器”部分包含有关第三方适配器配置的详细信息。

示例

创建 OAuth 2.0 凭据后，您便可以开始使用 AdMob API 了。如需使用 OAuth 2.0 请求访问权限，您的应用还需要提供作用域信息。

以下是 OAuth 2.0 范围信息：

范围 含义
https://www.googleapis.com/auth/admob.monetization 查看、创建和修改您的 AdMob 获利设置。
https://www.googleapis.com/auth/admob.readonly 查看所有 AdMob 数据。这可能包括账号信息、广告资源和中介设置、报告以及其他数据。 此类数据不包括敏感数据，例如付款或广告系列详细信息。

curl（命令行）

使用 curl 的请求

  1. 加载客户端密钥文件并生成授权凭据。

    第一次执行此步骤时，系统会在浏览器中提示您接受授权。接受之前，请务必使用可访问 AdMob API 的 Google 账号登录。您的应用将获得授权，能够代表当前登录的账号访问数据。

    对于身份验证和授权，我们建议使用 oauth2l，这是一个简单的命令行工具，用于与 Google OAuth 2.0 配合使用。安装 oauth2l 并运行以下命令，将 path_to_credentials_json 替换为您在注册云应用时下载的 credentials.json 文件的路径。首次运行时，该命令会一步步引导您完成 OAuth 2.0 授权流程。后续运行则自动刷新令牌。

    oauth2l header --json path_to_credentials_json --scope admob.readonly

  2. 列出适配器。

    将 pub-XXXXXXXXXXXXXXXX 替换为您的发布商 ID 即可获取 AdMob 适配器信息，请参阅如何查找发布商 ID。

    将 SSSSSSSSSSSSSSSSSSSS 替换为所需适配器的广告来源 ID。

    使用以下命令获取适配器列表：

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    以下是 ID 为 5450213213286189855 的 AdMob 广告联盟广告来源的响应示例：

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}