Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Creating a new search engine

...

A context file can be uploaded in the Advanced tab under 'Search engine context'.

Context: Defining a Programmable Search Engine on Google

Hiding Ads

To hide ads on the search results page, a Google Workspace / G-Suite superadmin must be added in the search engine Users tab and set as Administrator. Within a few days of doing so, Google will recognize the search engine as part of a non-profit / education institution. When that happens, the Show Ads toggle in the Ads tab can be switched to 'off'.

Information for non-profits on Google

Promotions

Warning

Google is very

...

temperamental with regard to promotions. If you attempt to manage them using the Google Programmable Search admin interface, things may get mixed up, particularly the order in which they appear. Because we have sooooo many, it's important to maintain order so that any particular promotion is more easily findable.

Deleting a promotion

This in the only use case where it is safe to use the Google Programmable Search admin interface. Delete away!

...

tite
AttributePurposeValue
idUniquely identifies the promotion and makes it distinct from other promotions. The value is used for sorting the list of promotions in the Google Programmable Search admin interface.The first 40 (or fewer) characters of the title value, all lower case.

Same value as title, but all lower case. Spaces are fine here.

Replace all ampersand "&" and slash "/" characters with underscore "_". 

titleThe promotion's title, displayed in search results.

Human-readable. Normal casing and punctuation.


(warning) Note - Sep 13, 2024
When importing from xml, Google will omit any promotions that include "&", ">", or "<" entities in the title attribute – even though these may have been included in an xml export. 

Replace these entities with non-special characters (e.g., replace "&" with "and") for the purposes of xml import. You can change each back to the desired entity after import using the Google interface.

queriesTriggers the display of a promotion is used an a search phrase.Comma-separated list of phrases.
urlThe link destination of the promotion.Complete web address, including http(s)://


Reordering promotions

  1. Export a promotions.xml file in the Promotions tab of the Search Features area.
  2. Download the promotions processor script from the repo.
  3. Run the script with the promotions.xml file in the same directory
  4. Delete all promotions from the search engine in question using the Google Programmable Search admin interface. This may take a lot of clicks.
  5. Upload the promotions-processed.xml file generated by the processor script to the search engine using the Google Programmable Search admin interface.