Display & Video 360 服务
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 Display & Video 360 (DV360) 服务,您可以在 Apps 脚本中使用 DV360 API。此 API 提供对 Display & Video API 的程序化访问权限。
参考
如需详细了解此服务,请参阅 DV360 API 的参考文档。与 Apps 脚本中的所有高级服务一样,DV360 服务使用的对象、方法和参数均与公共 API 相同。如需了解详情,请参阅方法签名是如何确定的。
如需报告问题并查找其他支持,请参阅 DV360 支持指南。
示例代码
以下示例代码使用 API 的版本 4。
获取合作伙伴列表
此示例会记录账号中的所有合作伙伴。
获取有效广告系列的列表
此示例会记录所有有效广告系列的名称和 ID。请注意,我们使用了分页令牌来检索整个列表。
更新订单项的显示名称
此示例用于更新订单项的显示名称
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[],[],null,["# Display & Video 360 Service\n\nThe Display \\& Video 360 (DV360) service lets you use the\n[DV360 API](/display-video)\nin Apps Script. This API provides programmatic access to the Display \\& Video API.\n| **Note:** This is an advanced service that must be [enabled before use](/apps-script/guides/services/advanced).\n\nReference\n---------\n\nFor detailed information on this service, see the\n[reference documentation](/display-video/api/reference/rest) for the\nDV360 API. Like all advanced services in Apps\nScript, the DV360 service uses the same objects, methods, and\nparameters as the public API. For more information, see [How method signatures are determined](/apps-script/guides/services/advanced#how_method_signatures_are_determined).\n\nTo report issues and find other support, see the\n[DV360 support guide](/display-video/api/support).\n\nSample code\n-----------\n\nThe following sample code uses\n[version 4](/display-video/api/reference/rest/v4) of the API.\n\n### Get a list of partners\n\nThis sample logs all of the partners available in the account. \nadvanced/displayvideo.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/advanced/displayvideo.gs) \n\n```javascript\n/**\n * Logs all of the partners available in the account.\n */\nfunction listPartners() {\n // Retrieve the list of available partners\n try {\n const partners = DisplayVideo.Partners.list();\n\n if (partners.partners) {\n // Print out the ID and name of each\n for (let i = 0; i \u003c partners.partners.length; i++) {\n const partner = partners.partners[i];\n console.log('Found partner with ID %s and name \"%s\".',\n partner.partnerId, partner.displayName);\n }\n }\n } catch (e) {\n // TODO (Developer) - Handle exception\n console.log('Failed with error: %s', e.error);\n }\n}\n```\n\n### Get a list of active campaigns\n\nThis sample logs names and IDs of all active campaigns. Note the use of\npaging tokens to retrieve the whole list. \nadvanced/displayvideo.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/advanced/displayvideo.gs) \n\n```javascript\n/**\n * Logs names and ID's of all active campaigns.\n * Note the use of paging tokens to retrieve the whole list.\n */\nfunction listActiveCampaigns() {\n const advertiserId = '1234567'; // Replace with your advertiser ID.\n let result;\n let pageToken;\n try {\n do {\n result = DisplayVideo.Advertisers.Campaigns.list(advertiserId, {\n 'filter': 'entityStatus=\"ENTITY_STATUS_ACTIVE\"',\n 'pageToken': pageToken\n });\n if (result.campaigns) {\n for (let i = 0; i \u003c result.campaigns.length; i++) {\n const campaign = result.campaigns[i];\n console.log('Found campaign with ID %s and name \"%s\".',\n campaign.campaignId, campaign.displayName);\n }\n }\n pageToken = result.nextPageToken;\n } while (pageToken);\n } catch (e) {\n // TODO (Developer) - Handle exception\n console.log('Failed with error: %s', e.error);\n }\n}\n```\n\n### Update the display name of a line item\n\nThis sample updates the display name of a line item \nadvanced/displayvideo.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/advanced/displayvideo.gs) \n\n```javascript\n/**\n * Updates the display name of a line item\n */\nfunction updateLineItemName() {\n const advertiserId = '1234567'; // Replace with your advertiser ID.\n const lineItemId = '123456789'; //Replace with your line item ID.\n const updateMask = \"displayName\";\n\n const lineItemDef = {displayName: 'New Line Item Name (updated from Apps Script!)'};\n\n try {\n const lineItem = DisplayVideo.Advertisers.LineItems\n .patch(lineItemDef, advertiserId, lineItemId, {updateMask:updateMask});\n\n\n } catch (e) {\n // TODO (Developer) - Handle exception\n console.log('Failed with error: %s', e.error);\n }\n}\n```"]]