Getting started

This guide will take you through the steps needed to set-up, develop and launch a new Things to do feed.

Initial Setup

To create accounts and SFTP endpoints Google requires you to provide SSH keys to use as upload credentials. Once this is provided, Google will create two SFTP end points (one for development and another for production) and a Things to do partner front end account for you.

Generate a Secure Shell (SSH) key pair for SFTP dropbox

Please follow Generate a Secure Shell key pair for an SFTP dropbox to generate a pair of public and private SSH keys. This pair of keys is used to securely log in to the Google-provided SFTP dropboxes. The public key has the following format:

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCXsM9ycbHV6E6t2L+B4p/uYHn9Q0jmu5gUXMYnFnnf4l39xrznfDo8KCASzRrqUkRnuzrno059CvZVzcljkbwWLzKKoE1EwbzHL3nYahMB4MdYNWhBbHbB+ybq6RNO7hkoKDBIQCfqQDY0FEB6sV3d3F1WYl0bAMjp15yyZJzMKa/rRnZKWetHlcL1X+gFWmW2hQ93foPD463gb58/25GujjsS/tzjngw7UJMVkm08U1QEY3z3DE/R++7ovJozTCzH0CTNDN0AH3/oSC3dmG+yDh3ZXFATjWjyPXJSOziNrp9TXgJhlqSmoHcPvpotMVjx21kIZ+T+SusQmnG+hK+L user@yourdomain.com

Don't include new line breaks in the key.

Once the keys are created, please send them to your Google representative at which point two feeds will be created on your behalf.

Access to Partner Portal

Access to Things to do partner portal will be provided to you once the initial set-up has been completed by Google. As part of the initial onboarding, Google will reach out to you and ask for a list of users who will be owners of the partner portal. Each user on that list will be granted access to the portal and have owner permissions. These users can grant additional users access to the partner portal as needed and add additional owners.

Development and Testing

Once account and endpoints have been created, your Google representative will reach out to you with access details of the end point and partner front end. As you develop the feed, you can upload to the development end point at any point and check the processing results in the partner front end.

Uploading feed

Once you have received the feed details, you can upload feed created feed directly to the endpoint below:

SFTP URL: partnerupload.google.com.
SFTP Port: 19321
Username: username provided by Google

The private key matching the public key generated in the previous step will be needed for authentication. See Connect to your SFTP dropbox for a detailed example of connecting to SFTP dropbox.

Testing and validating feeds

Automated feed validation and ingestion occurs once a feed has been uploaded. Upload history, status and error messages can all be accessed via the partner frontend. During development and testing, you may freely upload to the partnerdev feed endpoint to trigger validation.

Once development is complete, partners can start uploading feeds to the production endpoint on a regular basis. After the first feeds have been uploaded, please reach out to your Google representative to trigger the launch process.

Launch to Production

Before turning the feed on to production, the Google team will do one final QA round on the production feed uploaded. Any feedback from the QA will be provided directly to your team and once all outstanding issues have been resolved, the Google team will launch your feed by enabling it in the backend.

Things to do ads integration

Once feed integration has been completed, please reach out to ttd-ads-support@google.com with a list of Google Ads accounts which may have access to the feed content to start the Ads integration.