Skip to main content
POST
Prove the caller has an external spreadsheet open
Returns a single-use proof valid for 15 minutes and one placement operation. Send it as placementProof when placing into this spreadsheet. EXCEL sends the workbook’s documentKey; GOOGLE_SHEETS sends identity and spreadsheet access tokens from the add-on’s Apps Script.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

externalWorkbookId
string
required

Body

application/json

IssuePlacementProofInput

host
enum<string>
required
Available options:
GOOGLE_SHEETS,
EXCEL
documentKey
string | null
googleAccessToken
string | null

Apps Script OAuth token with access to the requested spreadsheet.

googleIdToken
string | null
operation
enum<string> | null

Placement operation that will consume this proof.

Available options:
create,
update,
connect,
upsert

Response

200 - application/json
expiresAt
string
required
proof
string
required