[{"data":1,"prerenderedAt":382},["ShallowReactive",2],{"sdk-docs-navigation":3,"sdk-docs-page:\u002Fgscdump-sdk\u002Fguides\u002Foperate\u002Fkeys-and-scopes":112},[4],{"path":5,"title":6,"children":7,"stem":111,"page":16},"\u002Fgscdump-sdk","gscdump SDK",[8,27],{"path":9,"title":10,"children":11,"stem":25,"page":26},"\u002Fgscdump-sdk\u002Fapi","Api",[12,17,21],{"path":13,"title":14,"stem":15,"page":16},"\u002Fgscdump-sdk\u002Fapi\u002Fdirect-client","Direct client exports","api\u002F1.direct-client",true,{"path":18,"title":19,"stem":20,"page":16},"\u002Fgscdump-sdk\u002Fapi\u002Fhosted-http","Hosted HTTP","api\u002F2.hosted-http",{"path":22,"title":23,"stem":24,"page":16},"\u002Fgscdump-sdk\u002Fapi\u002Frealtime","Realtime","api\u002F3.realtime","gscdump-sdk\u002Fapi",false,{"path":28,"title":29,"children":30,"stem":110,"page":26},"\u002Fgscdump-sdk\u002Fguides","Guides",[31,48,73,97],{"path":32,"title":33,"children":34,"stem":47,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fstart","Start",[35,39,43],{"path":36,"title":37,"stem":38,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fstart\u002Fchoose-access","Choose access","guides\u002F1.start\u002F1.choose-access",{"path":40,"title":41,"stem":42,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fstart\u002Fhosted-first-result","Hosted first result","guides\u002F1.start\u002F2.hosted-first-result",{"path":44,"title":45,"stem":46,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fstart\u002Fdirect-first-result","Direct first result","guides\u002F1.start\u002F3.direct-first-result","guides\u002F1.start\u002Findex",{"path":49,"title":50,"children":51,"stem":72,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data","Read data",[52,56,60,64,68],{"path":53,"title":54,"stem":55,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data\u002Fdirect-search-analytics","Direct Search Analytics","guides\u002F2.read-data\u002F1.direct-search-analytics",{"path":57,"title":58,"stem":59,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data\u002Fhosted-analytics","Hosted analytics","guides\u002F2.read-data\u002F2.hosted-analytics",{"path":61,"title":62,"stem":63,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data\u002Fhosted-indexing","Hosted indexing","guides\u002F2.read-data\u002F3.hosted-indexing",{"path":65,"title":66,"stem":67,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data\u002Fhosted-sitemaps","Hosted sitemaps","guides\u002F2.read-data\u002F4.hosted-sitemaps",{"path":69,"title":70,"stem":71,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fread-data\u002Fdirect-bing","Direct Bing","guides\u002F2.read-data\u002F5.direct-bing","guides\u002F2.read-data\u002Findex",{"path":74,"title":75,"children":76,"stem":96,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations","Build integrations",[77,81,85,89,92],{"path":78,"title":79,"stem":80,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations\u002Fnuxt","Nuxt","guides\u002F3.build-integrations\u002F1.nuxt",{"path":82,"title":83,"stem":84,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations\u002Fnextjs","Next.js","guides\u002F3.build-integrations\u002F2.nextjs",{"path":86,"title":87,"stem":88,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations\u002Fhono-express","Hono \u002F Express","guides\u002F3.build-integrations\u002F3.hono-express",{"path":90,"title":23,"stem":91,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations\u002Frealtime","guides\u002F3.build-integrations\u002F4.realtime",{"path":93,"title":94,"stem":95,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Fbuild-integrations\u002Fwebhooks","Webhooks","guides\u002F3.build-integrations\u002F5.webhooks","guides\u002F3.build-integrations\u002Findex",{"path":98,"title":99,"children":100,"stem":109,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Foperate","Operate",[101,105],{"path":102,"title":103,"stem":104,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Foperate\u002Fkeys-and-scopes","Keys and scopes","guides\u002F4.operate\u002F1.keys-and-scopes",{"path":106,"title":107,"stem":108,"page":16},"\u002Fgscdump-sdk\u002Fguides\u002Foperate\u002Ferrors-and-retry","Errors and retry","guides\u002F4.operate\u002F2.errors-and-retry","guides\u002F4.operate\u002Findex","gscdump-sdk\u002Fguides","index",{"title":113,"description":114,"body":115,"id":376,"path":102,"stem":104,"extension":377,"navigation":378,"seo":379,"_source":380,"sitemap":381},"Set up keys and scopes for hosted data","Match credential class, fixed scopes, and Site ownership.",{"toc":116,"nodes":143,"frontmatter":363,"meta":365},{"links":117,"title":142,"searchDepth":128,"depth":128},[118,122,133,136,139],{"id":119,"text":120,"depth":121},"choose-a-credential-class","Choose a credential class",2,{"id":123,"text":124,"depth":121,"children":125},"create-and-store-a-user-api-key","Create and store a user API key",[126,130],{"id":127,"depth":128,"text":129},"create-and-store-a-user-api-key-self-service-key",3,"Self-service key",{"id":131,"depth":128,"text":132},"create-and-store-a-user-api-key-partner-issued-key","Partner-issued key",{"id":134,"text":135,"depth":121},"check-scope-and-site-ownership","Check scope and Site ownership",{"id":137,"text":138,"depth":121},"rotate-or-revoke-a-key","Rotate or revoke a key",{"id":140,"text":141,"depth":121},"diagnose-forbidden-access","Diagnose forbidden access","",[144,148,152,155,201,223,225,228,236,238,249,260,262,336,343,345,348,350],[145,146,113],"h1",{"id":147},"set-up-keys-and-scopes-for-hosted-data",[149,150,151],"p",{},"Hosted v1 checks the credential class, required scope, and resource ownership for each operation.",[153,154,120],"h2",{"id":119},[156,157,159,175],"table",{"tabindex":158},0,[160,161,162],"thead",{},[163,164,165,169,172],"tr",{},[166,167,168],"th",{},"Class",[166,170,171],{},"Used by",[166,173,174],{},"Access",[176,177,178,190],"tbody",{},[163,179,180,184,187],{},[181,182,183],"td",{},"User API key",[181,185,186],{},"Your own server integration",[181,188,189],{},"Its user and authorized Sites",[163,191,192,195,198],{},[181,193,194],{},"Partner key",[181,196,197],{},"A linked partner integration",[181,199,200],{},"Linked users, Teams, and authorized Sites",[149,202,203,204,209,210,214,215,218,219,222],{},"The ",[205,206,208],"a",{"href":207},"\u002Fgscdump-sdk\u002Fapi\u002Fhosted-http#api-specifications","hosted HTTP specification"," publishes each operation's ",[211,212,213],"code",{},"security",", ",[211,216,217],{},"x-gscdump-scopes",", and ",[211,220,221],{},"x-gscdump-ownership"," fields.",[153,224,124],{"id":123},[226,227,129],"h3",{"id":127},[149,229,230,231,235],{},"Generate the key in ",[205,232,234],{"href":233},"\u002Fapp\u002Fdevelopers#api-keys","Agent setup",". Copy it once and store it in a server secret store. User keys have a fixed scope set. You do not select scopes during creation.",[226,237,132],{"id":131},[149,239,240,241,244,245,248],{},"A partner can create a key for a linked user with ",[211,242,243],{},"createUserApiKey",". This method requires a partner key and ",[211,246,247],{},"users:write","; it is not a user self-service SDK call.",[149,250,251,252,255,256,259],{},"Send the key as ",[211,253,254],{},"Authorization: Bearer \u003Ckey>",". The SDK does this through ",[211,257,258],{},"credential: () => key",". Never put a key in a URL, browser bundle, browser storage, WebSocket frame, or log.",[153,261,135],{"id":134},[156,263,264,277],{"tabindex":158},[160,265,266],{},[163,267,268,271,274],{},[166,269,270],{},"Operation",[166,272,273],{},"Scope",[166,275,276],{},"Resource check",[176,278,279,294,308,322],{},[163,280,281,286,291],{},[181,282,283],{},[211,284,285],{},"queryAnalyticsRows",[181,287,288],{},[211,289,290],{},"analytics:execute",[181,292,293],{},"Authorized Site",[163,295,296,301,306],{},[181,297,298],{},[211,299,300],{},"getSiteIndexing",[181,302,303],{},[211,304,305],{},"indexing:read",[181,307,293],{},[163,309,310,315,320],{},[181,311,312],{},[211,313,314],{},"inspectSiteUrls",[181,316,317],{},[211,318,319],{},"indexing:write",[181,321,293],{},[163,323,324,329,334],{},[181,325,326],{},[211,327,328],{},"getSiteSitemaps",[181,330,331],{},[211,332,333],{},"sitemaps:read",[181,335,293],{},[149,337,338,339,342],{},"An allowed scope alone does not grant a different Site. Use its exact ",[211,340,341],{},"siteId",".",[153,344,138],{"id":137},[149,346,347],{},"Add a new key to the server secret store, deploy it, then revoke the old key. A partner can use its partner-only key methods for keys it issued. Check active clients before revocation.",[153,349,141],{"id":140},[149,351,352,353,356,357,360,361,342],{},"For ",[211,354,355],{},"401",", check that the Bearer key is present and active. For ",[211,358,359],{},"403",", check the operation's credential class, scope, Site ownership, and Site ID. Include the request ID in support reports. See ",[205,362,107],{"href":106},{"title":113,"navigation":364,"description":114},{"title":103},{"title":113,"description":151,"toc":366},{"title":142,"searchDepth":128,"depth":128,"links":367},[368,369,373,374,375],{"id":119,"depth":121,"text":120},{"id":123,"depth":121,"text":124,"children":370},[371,372],{"id":127,"depth":128,"text":129},{"id":131,"depth":128,"text":132},{"id":134,"depth":121,"text":135},{"id":137,"depth":121,"text":138},{"id":140,"depth":121,"text":141},"sdkDocs\u002Fguides\u002F4.operate\u002F1.keys-and-scopes.md","md",{"title":103},{"title":113,"description":114},"\u002Fopt\u002Factions-runner\u002F_work\u002Fgscdump.com\u002Fgscdump.com\u002Fnode_modules\u002F.cache\u002Fcomark-content\u002Fgit\u002Fd100867c457f148bef5f\u002Fdocs\u002Fgscdump-sdk\u002Fguides\u002F4.operate\u002F1.keys-and-scopes.md",{"loc":102},1794983848644]