Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
PropriedadesServiço
Permite que os scripts armazenem dados simples em pares de chave-valor no escopo de um script, um usuário de um
script ou um documento em que um complemento é usado. As propriedades não podem ser compartilhadas entre scripts.
Para mais informações sobre quando usar cada tipo de propriedade, consulte o guia do serviço de propriedades.
// Sets three properties of different types.constdocumentProperties=PropertiesService.getDocumentProperties();constscriptProperties=PropertiesService.getScriptProperties();constuserProperties=PropertiesService.getUserProperties();documentProperties.setProperty('DAYS_TO_FETCH','5');scriptProperties.setProperty('SERVER_URL','http://www.example.com/MyWeatherService/',);userProperties.setProperty('DISPLAY_UNITS','metric');
Retorna um repositório de propriedades que só o usuário atual pode acessar e apenas neste script.
Documentação detalhada
getDocumentProperties()
Extrai uma loja de propriedades (somente para este script) que todos os usuários podem acessar no documento,
na planilha ou no formulário aberto. Ele só estará disponível se o script for publicado e executado
como um complemento ou se estiver vinculado a um tipo de arquivo
do Google. Quando as propriedades do documento não estão disponíveis, esse método retorna null. As propriedades
de documento criadas por um script não são acessíveis fora dele, nem mesmo por outros scripts
que acessem o mesmo documento.
Retornar
Properties: um repositório de propriedades para este script que todos os usuários do documento atual podem acessar ou null se o script não for um complemento ou não estiver vinculado a um arquivo do Google Workspace.
getScriptProperties()
Extrai uma loja de propriedades que todos os usuários podem acessar, mas apenas neste script.
Retornar
Properties: um repositório de propriedades que todos os usuários do script podem acessar
getUserProperties()
Retorna um repositório de propriedades que só o usuário atual pode acessar e apenas neste script.
Retornar
Properties: uma loja de propriedades que só o usuário atual do script pode acessar
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThe Properties Service lets Apps Script store simple data as key-value pairs, with different scopes for scripts, users, and documents.\u003c/p\u003e\n"],["\u003cp\u003eIt offers three methods to access properties: \u003ccode\u003egetDocumentProperties()\u003c/code\u003e, \u003ccode\u003egetScriptProperties()\u003c/code\u003e, and \u003ccode\u003egetUserProperties()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetDocumentProperties()\u003c/code\u003e provides property storage accessible to all users within a specific document, spreadsheet, or form where the script is running.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetScriptProperties()\u003c/code\u003e allows storing properties accessible to all users, but only within the context of the current script.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetUserProperties()\u003c/code\u003e provides a property store specific to the current user and accessible only within the current script.\u003c/p\u003e\n"]]],["The `PropertiesService` stores data in key-value pairs, accessible via `getDocumentProperties`, `getScriptProperties`, and `getUserProperties`. `getDocumentProperties` stores data within a specific document, accessible to all users. `getScriptProperties` stores data within a script, accessible to all users. `getUserProperties` stores data for a single user within a script. The example code demonstrates setting properties using each method: `setProperty`. Each method returns a `Properties` object, which is a property store.\n"],null,[]]