AI Search
New
InMobi Now
提交支持工单
后退

API详情

Chinese
English
Chinese

管理应用

  1. 获取应用列表 

    • 请求 URL：https://publisher.inmobi.com/rest/api/v2/apps
    • 请求方法：GET 
    • 请求参数（查询）： 
      姓名  描述  必需的  类型  样本/可用值 
      页码   页码  选修的  整数  1、2、3 等。 
      页面长度   每页记录数  选修的  整数

      1、2、3 等。 

      默认结果数：10 
      地位   应用状态  选修的  细绳 

      可用值：ACTIVE、DRAFT、ARCHIVE、FLAGGED 

      默认值：启用 
    • 请求体：不适用
    • 回复格式
      • 回复正文： 
        { 
  "success": true, 
  "data": { 
    "totalRecords": 281, 
    "records": [ 
      { 
        "storeUrl": "string", 
        "appName": "string", 
        "platform": "string", 
        "bundleId": "string", 
        "childDirected": 1, 
        "appRating": "string", 
        "appId": 0 
      } 
    ] 
  } 
}
      • 响应体值：
        姓名  描述  类型  示例/可能值 
        成功 决定响应是否成功 布尔值

        成功 - 请求成功

        false – 请求失败，出现错误
        存储网址 应用商店/Play商店的应用网址 字符串（url） URL
        appName 应用名称 细绳 示例应用程序
        平台 应用平台 细绳 Android 或 iPhone (iOS)
        bundleId 应用商店中注册的应用包 细绳 Com.org.app
        儿童指导 决定应用的目标受众类型 整数

        1 → "App is directed towards children"

        2 → "App is NOT directed towards children"

        3 → "App is partially directed (mixed audience)"
        appRating 该应用的内容评级 细绳  
        appId InMobi 控制面板上的应用程序 ID 数字  

  2. 获取特定应用的详细信息

    • 请求 URL：https://publisher.inmobi.com/rest/api/v2/apps/ {appId}（请求 URL 中应包含应用 ID）
    • 请求方法：GET
    • 请求参数（查询）：不适用
    • 请求体：不适用
    • 回复格式
      • 回复正文： 
        
{ 
  "success": true, 
  "data": { 
    "storeUrl": "string", 
    "appName": "string", 
    "platform": "string", 
    "bundleId": "string", 
    "childDirected": 0, 
    "appRating": "string", 
    "appId": 0 
  }, 
  "status": "string", 
  "createdOn": "string" 
}
      • 响应体值：
        姓名  描述  类型  示例/可能值 
        成功 决定响应是否成功 布尔值

        成功 - 请求成功

         

        false – 请求失败，出现错误
        存储网址 应用商店/Play商店的应用网址 字符串（url） URL
        appName 应用名称 细绳 示例应用程序
        平台 应用平台 细绳 Android 或 iOS
        bundleId 应用商店中注册的应用包 细绳 Com.org.app
        儿童指导 决定应用的目标受众类型 整数

        1 – 本应用并非面向儿童

        2 – 此应用面向儿童，需要家长同意

        3 – 该应用部分面向儿童，部分面向成人
        appRating 该应用的内容评级 细绳  
        appId InMobi 控制面板上的应用程序 ID 数字  
        地位 该应用在平台上的当前状态 细绳 待审核、进行中、已标记、已拒绝、已存档
        创建于 应用在平台上的创建日期 细绳  

  3. 创建新应用

    • 请求 URL：https://publisher.inmobi.com/rest/api/v2/apps
    • 请求方法：POST
    • 请求参数（查询）：不适用
    • 请求正文：
      • 模式： 
        { 
  "storeUrl": "string", 
  "childDirected": 0, 
  "locationAccess": true, 
  "appName": "string" 
}
      • 请求体值：
        姓名  描述  必需的  类型  示例/可能值 
        存储网址 应用商店/Play商店的应用网址 必需的 字符串（url） URL
        位置访问 指定 InMobi 是否可以访问位置详细信息 必需的 布尔值

        没错——InMobi 将能够使用此应用程序收集的位置数据。

        错误 – InMobi 将无法访问此应用程序收集的位置数据。
        儿童指导 指定应用的受众类型 必需的 整数

        1 – 本应用并非面向儿童

        2 – 此应用面向儿童，需要家长同意

        3 – 该应用部分面向儿童，部分面向成人
        appName 应用名称 选修的 细绳 示例应用程序
      • 回复格式：
        • 回复正文： 
          { 
  "success": true, 
  "data": { 
    "storeUrl": "string", 
    "appName": "string", 
    "platform": "string", 
    "bundleId": "string", 
    "childDirected": 0, 
    "appRating": "string", 
    "appId": 0 
  }, 
  "status": "string", 
  "createdOn": "string" 
}
        • 响应参数：
          姓名  描述  类型  示例/可能值 
          成功 决定响应是否成功 布尔值 成功 - 请求成功
          存储网址 应用商店/Play商店的应用网址 字符串（url） URL
          appName 应用名称 细绳 示例应用程序
          平台 应用平台 细绳 Android 或 iOS
          bundleId 应用商店中注册的应用包 细绳 Com.bundle.app
          儿童指导 决定应用的目标受众类型 整数

          1 – 本应用并非面向儿童

          2 – 此应用面向儿童，需要家长同意

          3 – 该应用部分面向儿童，部分面向成人
          appRating 该应用的内容评级 细绳  
          appId InMobi 控制面板上的应用程序 ID 数字  
          地位 该应用在平台上的当前状态 细绳 待审核、进行中、已标记、已拒绝、已存档
          创建于 应用在平台上的创建日期 细绳  

  4. 更新现有应用

    • 请求 URL：https://publisher.inmobi.com/rest/api/v2/apps/ {appId}（请求 URL 中应包含应用 ID）
    • 请求方法：PATCH
    • 请求参数（查询）：不适用
    • 请求正文：
      • 模式： 
        { 

  "childDirected": 0, 

  "locationAccess": true, 

  "appName": "string" 

}
      • 请求体值：
        姓名  描述  必需的  类型  示例/可能值 
        位置访问 指定 InMobi 是否可以访问位置详细信息 必需的 布尔值

        没错——InMobi 将能够使用此应用程序收集的位置数据。

        错误 – InMobi 将无法访问此应用程序收集的位置数据。
        儿童指导 指定应用的受众类型 必需的 整数

        1 – 本应用并非面向儿童

        2 – 此应用面向儿童，需要家长同意

        3 – 该应用部分面向儿童，部分面向成人
        appName 应用名称 选修的 细绳 示例应用程序
      • 回复格式：
        • 回复正文： 
          { 
  "success": true, 
  "data": { 
    "storeUrl": "string", 
    "appName": "string", 
    "platform": "string", 
    "bundleId": "string", 
    "childDirected": 0, 
    "appRating": "string", 
    "appId": 0 
  }, 
  "status": "string", 
  "createdOn": "string" 
}
        • 响应参数：
          姓名  描述  类型  示例/可能值 
          成功 决定响应是否成功 布尔值 成功- 请求成功
          存储网址 应用商店/Play商店的应用网址 字符串（url） URL
          appName 应用名称 细绳 示例应用程序
          平台 应用平台 细绳 Android 或 iOS
          bundleId 应用商店中注册的应用包 细绳 Com.bundle.app
          儿童指导 决定应用的目标受众类型 整数

          1 – 本应用并非面向儿童

          2 – 此应用面向儿童，需要家长同意

          3 – 该应用部分面向儿童，部分面向成人
          appRating 该应用的内容评级 细绳  
          appId InMobi 控制面板上的应用程序 ID 数字  
          地位 该应用在平台上的当前状态 细绳 待审核、进行中、已标记、已拒绝、已存档
          创建于 应用在平台上的创建日期 选修的   

管理职位安排

  1. 在应用程序中获取职位列表 

    • 请求 URL：https://publisher.inmobi.com/rest/api/v1/placements 
    • 请求方法：GET 
    • 请求参数（查询）： 
      姓名  描述  必需的  类型  样本/可用值 
      页码   页码  选修的  整数  1、2、3 等。 
      页面长度   每页记录数  选修的  整数

      1、2、3 等。 

      默认结果数：10 
      appId    应用程序的ID   必需的   整数  

       
      位置类型  安置类型  选修的  细绳  可用值：插页式广告、横幅广告、激励视频广告、原生广告 
    • 请求体：不适用
    • 回复格式
      • 回复正文： 
        { 
  "success": true, 
  "data": { 
    "totalRecords": 281, 
    "records": [ 
      { 
        "storeUrl": "string", 
        "appName": "string", 
        "platform": "string", 
        "bundleId": "string", 
        "childDirected": true, 
        "appRating": "string", 
        "appId": 0 
      }, 
      { 
        "placementId": 0, 
        "placementName": "string", 
        "placementType": "string", 
        "testMode": "string", 
        "status": "string", 
        "appId": 0, 
        "cpmFloor": 0, 
        "isAudienceBiddingEnabled": true, 
        "audienceBiddingPartner": "string", 
        "a9TagId": "string", 
        "a9AppId": "string", 
        "isFallbackPlacement": true, 
        "createdOn": "string" 
      } 
    ] 
  } 
}
      • 响应参数：
        姓名  描述  类型  示例/可能值 
        成功 决定响应是否成功 布尔值

        成功 - 请求成功

        false – 请求失败，出现错误
        存储网址 应用商店/Play商店的应用网址 字符串（url） URL
        appName 应用名称 细绳  
        平台 应用平台 细绳 Android 或 iPhone (iOS)
        bundleId 应用商店中注册的应用包 细绳 Com.org.app
        儿童指导 决定应用的目标受众类型 整数

        1 – 本应用并非面向儿童

        2 – 此应用面向儿童，需要家长同意

        3 – 该应用部分面向儿童，部分面向成人
        appRating 该应用的内容评级 细绳  
        appId InMobi平台上的应用程序密钥  整数   
        placementId  InMobi平台上的广告位ID  整数   
        位置名称  在 InMobi 平台上的广告位名称  细绳   
        位置类型  实习类型  细绳  可用值：插页式广告、横幅广告、激励视频广告、原生广告 
        测试模式  测试模式  细绳 

        开启 - 测试模式已针对 InMobi 平台集成测试中提到的特定设备开启 

        全球 – 所有安装了此应用的设备均已开启测试模式 

        关闭 – 此应用的所有设备的测试模式均已关闭 
        地位  当前安置状态  细绳  可用值：ACTIVE、DRAFT、ARCHIVE、FLAGGED 
        cpm地板  InMobi平台上的eCPM底线已设定  数字   
        isAudienceBiddingEnabled  确定此广告位是否启用受众竞价。  布尔值 

        没错——受众竞价功能已开启 

        错误 – 受众竞价已关闭 

         观众竞价伙伴 

        		 受众竞价合作伙伴（仅当启用受众竞价时适用）  细绳  可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING 
        a9TagId  标签 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
        A9AppId 应用 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
        创建于  安置创建日期  细绳   

  2. 获取应用中特定广告位的详细信息

    • 请求 URL：https://publisher.inmobi.com/rest/api/v1/placements/ {placementId}（请求 URL 中应包含广告位 ID）
    • 请求方法：GET
    • 请求参数（查询）：不适用
    • 请求体：不适用
    • 回复格式
      • 回复正文： 
        { 

  "success": true, 

  "data": { 

    "placementId": 0, 

    "placementName": "string", 

    "placementType": "string", 

    "testMode": "string", 

    "status": "string", 

    "appId": 0, 

    "cpmFloor": 0, 

    "isAudienceBiddingEnabled": true, 

    "audienceBiddingPartner": "string", 

    "a9TagId": "string", 

    "a9AppId": "string", 

    "isFallbackPlacement": true, 

    "createdOn": "string" 

  } 

}
      • 响应参数：
        姓名  描述  类型  示例/可能值 
        成功 决定响应是否成功 布尔值

        成功 - 请求成功

        false – 请求失败，出现错误
        appId InMobi平台上的应用程序密钥  整数   
        placementId  InMobi平台上的广告位ID  整数   
        位置名称  在 InMobi 平台上的广告位名称  细绳   
        位置类型  实习类型  细绳  可用值：插页式广告、横幅广告、激励视频广告、原生广告 
        测试模式  测试模式  细绳 

        开启 - 测试模式已针对 InMobi 平台集成测试中提到的特定设备开启 

        全球 – 所有安装了此应用的设备均已开启测试模式 

        关闭 – 此应用的所有设备的测试模式均已关闭 
        地位  当前安置状态  细绳  可用值：ACTIVE、DRAFT、ARCHIVE、FLAGGED 
        cpm地板  InMobi平台上的eCPM底线已设定  数字   
        isAudienceBiddingEnabled  确定此广告位是否启用受众竞价。  布尔值 

        没错——受众竞价功能已开启 

        错误 – 受众竞价已关闭 

         观众竞价伙伴 

        		 受众竞价合作伙伴（仅当启用受众竞价时适用）  细绳  可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING 
        a9TagId  标签 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
        A9AppId 应用 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
        创建于  安置创建日期  细绳   

  3. 在应用中创建新的广告位

    • 请求 URL：https://publisher.inmobi.com/rest/api/v1/placements
    • 请求方法：POST
    • 请求参数（查询）：不适用
    • 请求正文：
      • 模式： 
        { 

  "appId": 0, 

  "placementName": "string", 

  "placementType": "INTERSTITIAL", 

  "cpmFloor": 0, 

  "isAudienceBiddingEnabled": true, 

  "audienceBiddingPartner": "string", 

  "a9TagId": "string", 

  "a9AppId": "string", 

  "isFallbackPlacement": true 

}
      • 请求体值：
        姓名  描述  必需的  类型  示例/可能值 
        appId InMobi平台上的应用程序密钥 必需的 整数  
        位置名称 在 InMobi 平台上的广告位名称 必需的 细绳  
        位置类型 实习类型 必需的 细绳 可用值：插页式广告、横幅广告、激励视频广告、原生广告
        cpm地板 InMobi平台上的eCPM底线已设定 可选（如果 isAudienceBiddingEnabled 为“true”，则不适用） 数字  
        isAudienceBiddingEnabled 确定此广告位是否启用受众竞价。 必需的 布尔值 真 - 受众竞价已开启；假 - 受众竞价已关闭
        观众竞价伙伴 受众竞价合作伙伴（仅当启用受众竞价时适用） 必填（仅当 isAudienceBiddingEnabled 为“true”时） 细绳 可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING
        a9TagId 亚马逊TAM广告位标签ID 必填（仅当 Amazon TAM 作为受众竞价合作伙伴时） 细绳  
        A9AppId 亚马逊 TAM 位置的应用 ID 必填（仅当 Amazon TAM 作为受众竞价合作伙伴时） 细绳  
      • 回复格式：
        • 响应体结构： 
          { 
  "success": true, 
  "data": { 
    "placementId": 0, 
    "placementName": "string", 
    "placementType": "string", 
    "testMode": "string", 
    "status": "string", 
    "appId": 0, 
    "cpmFloor": 0, 
    "isAudienceBiddingEnabled": true, 
    "audienceBiddingPartner": "string", 
    "a9TagId": "string", 
    "a9AppId": "string", 
    "isFallbackPlacement": true, 
    "createdOn": "string" 
  } 
}
        • 响应值：
          姓名  描述  类型  示例/可能值 
          成功 决定响应是否成功 布尔值

          成功 - 请求成功 

          false – 请求失败，出现错误 
          placementId  InMobi平台上的广告位ID  整数   
          位置名称  在 InMobi 平台上的广告位名称  细绳  
          位置类型  实习类型  细绳 可用值：插页式广告、横幅广告、激励视频广告、原生广告 
          测试模式  测试模式  细绳 开启 – 测试模式已针对 InMobi 平台集成测试中提到的特定设备开启 

          全球 – 所有安装了此应用的设备均已开启测试模式 

          关闭 – 此应用的所有设备的测试模式均已关闭
          cpm地板  InMobi平台上的eCPM底线已设定  数字 

           
          isAudienceBiddingEnabled  确定此广告位是否启用受众竞价。  布尔值 

          没错——受众竞价功能已开启 

          错误 – 受众竞价已关闭 
          观众竞价伙伴  受众竞价合作伙伴（仅当启用受众竞价时适用）  细绳 

          可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING 
          appId InMobi平台上的应用程序密钥  整数  
          a9TagId  标签 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
          A9AppId  应用 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
          地位 当前安置状态  细绳 可用值：ACTIVE、DRAFT、ARCHIVE、FLAGGED 
          创建于 安置创建日期  细绳  

  4. 更新应用中的现有广告位

    • 请求 URL：  https://publisher.inmobi.com/rest/api/v1/placements/{placementId}  （请求 URL 中应包含广告位 ID）
    • 请求方法：PATCH
    • 请求参数（查询）：不适用
    • 请求正文：
      • 模式： 
        { 

  "placementName": "string", 

  "cpmFloor": 0, 

  "isAudienceBiddingEnabled": true, 

  "audienceBiddingPartner": "string", 

  "a9TagId": "string", 

  "a9AppId": "string", 

}
      • 请求体值：
        姓名  描述  必需的  类型  示例/可能值 
        位置名称 在 InMobi 平台上的广告位名称 必需的 细绳  
        cpm地板 InMobi平台上的eCPM底线已设定 可选（如果 isAudienceBiddingEnabled 为“true”，则不适用） 数字  
        isAudienceBiddingEnabled 确定此广告位是否启用受众竞价。 选修的 布尔值 真 - 受众竞价已开启；假 - 受众竞价已关闭
        观众竞价伙伴 受众竞价合作伙伴（仅当启用受众竞价时适用） 必填（仅当 isAudienceBiddingEnabled 为“true”时） 细绳 可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING
        a9TagId 亚马逊TAM广告位标签ID 必填（仅当 Amazon TAM 作为受众竞价合作伙伴时） 细绳  
        A9AppId 亚马逊 TAM 位置的应用 ID 必填（仅当 Amazon TAM 作为受众竞价合作伙伴时） 细绳  
      • 回复格式：
        • 回复正文： 
          { 
  "success": true, 
  "data": { 
    "placementId": 0, 
    "placementName": "string", 
    "placementType": "string", 
    "testMode": "string", 
    "status": "string", 
    "appId": 0, 
    "cpmFloor": 0, 
    "isAudienceBiddingEnabled": true, 
    "audienceBiddingPartner": "string", 
    "a9TagId": "string", 
    "a9AppId": "string", 
    "isFallbackPlacement": true, 
    "createdOn": "string" 
  } 
}
        • 响应体值：
          姓名  描述  类型  示例/可能值 
          成功 决定响应是否成功 布尔值

          成功 - 请求成功 

          false – 请求失败，出现错误 
          placementId  InMobi平台上的广告位ID  整数   
          位置名称  在 InMobi 平台上的广告位名称  细绳  
          位置类型  实习类型  细绳 可用值：插页式广告、横幅广告、激励视频广告、原生广告 
          测试模式  测试模式  细绳 开启 – 测试模式已针对 InMobi 平台集成测试中提到的特定设备开启 

          全球 – 所有安装了此应用的设备均已开启测试模式 

          关闭 – 此应用的所有设备的测试模式均已关闭
          cpm地板  InMobi平台上的eCPM底线已设定  数字 

           
          isAudienceBiddingEnabled  确定此广告位是否启用受众竞价。  布尔值 

          没错——受众竞价功能已开启 

          错误 – 受众竞价已关闭 
          观众竞价伙伴  受众竞价合作伙伴（仅当启用受众竞价时适用）  细绳 

          可用值：MAX、AMAZON_TAM、GOOGLE_OPEN_BIDDING、CUSTOM_MEDIATION、IRONSOURCE、SPRINGSERVE、PREBID、FYBER、ADMOST、AEQUUS、GAMEANALYTICS_HYPERBID、CHARTBOOST、GOOGLE_SDK_BIDDING 
          appId InMobi平台上的应用程序密钥  整数  
          a9TagId  标签 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
          A9AppId  应用 ID（仅适用于 Amazon TAM 作为受众竞价合作伙伴的情况）  细绳   
          地位 当前安置状态  细绳 可用值：ACTIVE、DRAFT、ARCHIVE、FLAGGED 
          创建于 安置创建日期  细绳  

可能存在的错误 

以下是在使用这些 API 时可能出现的错误情况：

错误代码  类型  描述 
400  错误请求响应  请检查请求正文中传递的值是否正确且格式正确。
401  未经授权的请求响应  请检查请求头和身份验证中传递的值是否正确。 
500  内部服务器错误响应  内部出现问题。请稍后再试，或联系 InMobi 客户服务经理或技术支持（发送邮件至support@inmobi.com）。 

 速率限制 

每个发布商的请求速率在 15 分钟间隔内上限为 500 次请求。 

如有任何未解决的问题，请联系您的客户成功经理 (CSM) 或发送邮件至support@inmobi.com联系我们。您也可以在此处提交工单：https://support.inmobi.com/mytickets。 

本页内容

最后更新于 : 10 Sep, 2026
✕

You are almost there...

By installing this SDK update, you agree that your Children Privacy Compliance setting remains accurate or that you will update that setting, whenever there is a change in your app's audience. You may update the app's Children Privacy Compliance settings at https://publisher.inmobi.com/my-inventory/app-and-placements.

I AGREE