Search Console

Choose which properties to pull

Set which properties the nightly pull keeps current. Selecting a property that has never been pulled queues an immediate first pull: the response returns at once with its additive pull_state, and a bounded background task imports the last 180 days (or a larger configured backfill) for your account only. The queue is durable — a five-minute recovery sweep finishes anything the background task does not, and the token-free selection write means repeat submissions never reset a queued, running, failed or completed job, its retry timer or its fixed window. A failed job is retried only after an explicit Google reconnect, never by resubmitting the same selection. A missing Google configuration does not discard the queue or report the import complete. Requires the customer key's read scope; a revoked connection is refused with reconnect_required until it is reconnected, and the response is private, no-store. Unknown properties are refused; the daily read contract is unchanged.

patch/v1/gsc/properties

Request

  • Base URL: https://api.placementapi.com
  • URL: https://api.placementapi.com/v1/gsc/properties
  • Auth: HTTP bearer

Request body

selectedstring[] required

The exact property names to keep selected. Properties not listed are deselected; their stored rows are kept.

Response

OK

selectedstring[]

The selected property names, in the same order as properties.

nextstring

A short hint about what happens next; wording is not part of the contract.

Changes

No recorded changes to this operation across all 1 revision of this API.