Bulk Create Redirects

Creates up to 500 redirects.

Each redirect succeeds or fails on its own. A redirect whose from path is already taken fails with FROM_URL_EXISTS, and one that closes a loop with an earlier redirect in the same request fails with REDIRECT_LOOP, while the rest of the request goes ahead. Read those failures from results[].itemMetadata.error in a successful response, matched to the request by results[].itemMetadata.originalIndex. A malformed request, such as an empty redirects list, is rejected as a whole and returns no results.

A redirect that already exists with the same from, to, and options.groupRedirect is reported as a success with no id, and nothing is written for it.

A redirect that closes a loop with a redirect already on the site is created, and the loop-closing redirect is deleted. options.forceReplace does the same for a from path that's already taken by a redirect on the site, instead of failing that redirect. Neither deletion can be undone, so retrieve those redirects first if you need to restore them.

To create a single redirect, call Create Redirect.