广告单元映射

广告单元映射是第三方配置设置，可映射到 AdMob 广告单元，并使其能够向第三方广告联盟发出广告请求。

创建中介组时，广告单元映射用作 每个中介组订单项 的参数，作为指定广告单元发出第三方广告联盟请求的设置。 与 AdMob 界面不同，广告单元映射需要在中介组和中介组订单项之外单独创建 。创建后，您可以列出 所有广告单元映射，并在创建或更新 包含新广告单元映射的中介组订单项时将其用作参数。

示例

创建 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. 加载Secret 文件并生成授权凭据。

    第一次执行此步骤时，系统会在浏览器中提示您接受授权。接受之前，请务必使用可访问 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,admob.monetization

  2. 列出广告来源。

    将 pub-XXXXXXXXXXXXXXXX 替换为您的发布商 ID，以获取 AdMob 广告来源信息。请参阅有关如何查找发布商 ID 的 说明。

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

    示例响应：

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. 列出适配器。

    将 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"
     }]
  }]
}

  4. 创建广告单元映射。

    将 YYYYYYYYYY 替换为您的广告单元 ID 片段。广告单元 ID 片段是广告单元 ID 的最后 10 位数字，格式为“ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”。请参阅有关如何 查找广告单元 ID的说明。

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. 列出所有广告单元映射。

    将 YYYYYYYYYY 替换为您的广告单元 ID 片段。广告单元 ID 片段是广告单元 ID 的最后 10 位数字，格式为“ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”。请参阅有关如何 查找广告单元 ID的说明。

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

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}