Need clarification on API support for “Upload List” and “Schedule List” under Placement Exclusion Lists

[Hardeep Singh]

Dear Team,

While exploring Tools → Shared Library → Exclusion Lists → Placement Exclusion Lists in the Google Ads UI, I noticed there are new options to manage placement exclusions —

• New List

• Upload a List

• Schedule a List

I’ve attached screenshots for reference.

---

Questions:

1. Upload Placement Exclusion List via API

   • Is there any API or service available to perform “Upload a List” functionality programmatically?

   • If yes, please share which service (e.g. SharedSetService, SharedCriterionService, etc.) and a sample request.

2. Schedule Placement Exclusion List via API

   • Is there any API to schedule placement exclusion list uploads (as seen in the UI)?

   • If yes, how can we define schedule frequency, file source, and list mapping?

3. Source Options (Google Sheets / HTTPS / SFTP)

   • In both “Upload” and “Schedule” flows, the source dropdown shows:

     • Upload a file (only in Upload)

     • Google Sheets

     • HTTPS

     • SFTP

   • Does the API provide any way to connect or configure these data sources programmatically?

---

Goal:

We want to automate the creation, upload, and scheduling of placement exclusion lists using the Google Ads API — similar to the UI workflow.

Please confirm if any existing APIs support this or if it’s planned for future releases.

Attached:

• Screenshot 1: Main Exclusion Lists page (New / Upload / Schedule options)

• Screenshot 2: Upload placement exclusion list dialog (with source dropdown)

• Screenshot 3: Schedule placement exclusions dialog

Thank you for your guidance.

[Mahnoor Mano]

--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
 
You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwor...@googlegroups.com
To unsubscribe from this group, send email to
adwords-api...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups "Google Ads API and AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/adwords-api/630af6dc-71f9-4547-b2fa-f3031e957c2an%40googlegroups.com.

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

Kindly note that the Management and uploading of exclusion lists are available via the API, primarily through the SharedSetService and SharedCriterionService. The "Upload a List" functionality within the UI is essentially a batch creation of SharedCriterion resources contained within a single SharedSet.

SharedSetService: Utilized for creating the list itself, where you define the list type (e.g., NEGATIVE_PLACEMENTS).
SharedCriterionService: Employed to add the actual exclusions (the placements/URLs) to the list.
Indeed, the SharedSetService can be used to manage shared sets. Furthermore, to incorporate an exclusion list into a campaign, you can establish campaign shared sets using the CampaignSharedSetService.  You can refer to the following sample requests:

shared set 
"operations": [
    {
      "create": {
        "name": "My New API Placement Exclusion List",
        "type": "NEGATIVE_PLACEMENTS"
      }
    }
  ],

shared criterion

"operations": [
    {
      "create": {
        "sharedSet": "customers/YOUR_CUSTOMER_ID/sharedSets/SHARED_SET_ID_FROM_ABOVE",
        "placement": {
          "url": "example.com/bad-site-1"
        }
      }
    },
    {
      "create": {
        "sharedSet": "customers/YOUR_CUSTOMER_ID/sharedSets/SHARED_SET_ID_FROM_ABOVE",
        "placement": {
          "url": "example.com/bad-site-2"
        }
      }
    }
  ],

Currently, there is no dedicated API service that programmatically replicates the "Schedule a List" feature found in the Google Ads UI. However, the BatchJobService facilitates batch operations across various services without requiring the completion of each individual operation. In contrast to service-specific mutate operations, a single BatchJobService job can manage a diverse array of campaigns, ad groups, ads, criteria, labels, and feed items. Submitted jobs run concurrently, and BatchJobService automatically retries operations that fail due to transient issues, such as rate limit errors. For further details, please consult the 'Batch Processing' documentation.

The Google Ads API does not directly provide services to establish connections or configurations for these data sources (Google Sheets, HTTPS, SFTP) to enable automatic updates of shared sets.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-10-07 21:27:45Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u8TtZ:ref" (ADR-00334848)