Esta página foi traduzida pela API Cloud Translation.

Class Properties

O objeto de propriedades atua como a interface para acessar as propriedades do usuário, do documento ou do script. O tipo de propriedade específico depende do método dos três métodos de PropertiesService chamado PropertiesService.getDocumentProperties(), PropertiesService.getUserProperties() ou PropertiesService.getScriptProperties(). Não é possível compartilhar propriedades entre scripts. Para mais informações sobre os tipos de propriedade, consulte o guia do serviço de propriedades.

Métodos

Método	Tipo de retorno	Breve descrição
`deleteAllProperties()`	`Properties`	Exclui todas as propriedades no armazenamento `Properties` atual.
`deleteProperty(key)`	`Properties`	Exclui a propriedade com a chave fornecida no armazenamento `Properties` atual.
`getKeys()`	`String[]`	Recebe todas as chaves no armazenamento `Properties` atual.
`getProperties()`	`Object`	Recebe uma cópia de todos os pares de chave-valor no armazenamento atual de `Properties`.
`getProperty(key)`	`String`	Recebe o valor associado à chave fornecida no armazenamento `Properties` atual ou `null` se essa chave não existir.
`setProperties(properties)`	`Properties`	Define todos os pares de chave-valor do objeto especificado no armazenamento `Properties` atual.
`setProperties(properties, deleteAllOthers)`	`Properties`	Define todos os pares de chave-valor do objeto especificado no armazenamento `Properties` atual, opcionalmente excluindo todas as outras propriedades no armazenamento.
`setProperty(key, value)`	`Properties`	Define o par de chave-valor informado no armazenamento de `Properties` atual.

Documentação detalhada

`deleteAllProperties()`

Exclui todas as propriedades no armazenamento Properties atual.

// Deletes all user properties.
var userProperties = PropertiesService.getUserProperties();
userProperties.deleteAllProperties();

Retornar

Properties: esta loja de Properties para encadeamento

`deleteProperty(key)`

Exclui a propriedade com a chave fornecida no armazenamento Properties atual.

// Deletes the user property 'nickname'.
var userProperties = PropertiesService.getUserProperties();
userProperties.deleteProperty('nickname');

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	a chave da propriedade a ser excluída

Retornar

Properties: esta loja de Properties para encadeamento

`getKeys()`

Recebe todas as chaves no armazenamento Properties atual.

// Sets several properties, then logs the value of each key.
var scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperties({
  'cow': 'moo',
  'sheep': 'baa',
  'chicken': 'cluck'
});
var keys = scriptProperties.getKeys();
Logger.log('Animals known:');
for (var i = 0; i < keys.length; i++) {
  Logger.log(keys[i]);
}

Retornar

String[]: uma matriz de todas as chaves no armazenamento Properties atual

`getProperties()`

Recebe uma cópia de todos os pares de chave-valor no armazenamento atual de Properties. O objeto retornado não é uma visualização ao vivo da loja. Consequentemente, mudar as propriedades no objeto retornado não as atualiza automaticamente no armazenamento ou vice-versa.

// Sets several script properties, then retrieves them and logs them.
var scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperties({
  'cow': 'moo',
  'sheep': 'baa',
  'chicken': 'cluck'
});

var animalSounds = scriptProperties.getProperties();

// Logs:
// A chicken goes cluck!
// A cow goes moo!
// A sheep goes baa!
for (var kind in animalSounds) {
  Logger.log('A %s goes %s!', kind, animalSounds[kind]);
}

Retornar

Object: uma cópia de todos os pares de chave-valor no armazenamento Properties atual

`getProperty(key)`

Recebe o valor associado à chave fornecida no armazenamento Properties atual ou null se essa chave não existir.

// Gets the user property 'nickname'.
var userProperties = PropertiesService.getUserProperties();
var nickname = userProperties.getProperty('nickname');
Logger.log(nickname);

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	a chave para o valor da propriedade recuperar

Retornar

String: o valor associado à chave fornecida no armazenamento Properties atual

`setProperties(properties)`

Define todos os pares de chave-valor do objeto especificado no armazenamento Properties atual.

// Sets multiple user properties at once.
var userProperties = PropertiesService.getUserProperties();
var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'};
userProperties.setProperties(newProperties);

Parâmetros

Nome	Tipo	Descrição
`properties`	`Object`	um objeto que contém pares de chave-valor a serem definidos

Retornar

Properties: esta loja de Properties para encadeamento

`setProperties(properties, deleteAllOthers)`

Define todos os pares de chave-valor do objeto especificado no armazenamento Properties atual, opcionalmente excluindo todas as outras propriedades no armazenamento.

// Sets multiple user properties at once while deleting all other user properties.
var userProperties = PropertiesService.getUserProperties();
var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'};
userProperties.setProperties(newProperties, true);

Parâmetros

Nome	Tipo	Descrição
`properties`	`Object`	um objeto que contém pares de chave-valor a serem definidos
`deleteAllOthers`	`Boolean`	`true` para excluir todos os outros pares de chave-valor no objeto de propriedades, `false` para não

Retornar

Properties: esta loja de Properties para encadeamento

`setProperty(key, value)`

Define o par de chave-valor informado no armazenamento de Properties atual.

// Sets the user property 'nickname' to 'Bobby'.
var userProperties = PropertiesService.getUserProperties();
userProperties.setProperty('nickname', 'Bobby');

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	a chave da propriedade
`value`	`String`	o valor a ser associado à chave

Retornar

Properties: esta loja de Properties para encadeamento