Gigya Job Openings

Page History

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

RequiredFieldTypeDescription
Yes
typestringValue must be consent.
Yes
currentDocUri (TBD)stringThe URI of the document that this consent object is related to.
Varies
currentDocVersion*floatThe active version number of the consent statement. Either currentDocVersion or currentDocDate are required.
Varies
currentDocDate*dateThe active version date of the consent statement. Either currentDocVersion or currentDocDate are required.
No
customdataArray of objects

An array of custom data objects that are part of the schema for this consent statement. Each data set is comprised of a key-value pair. Both of these are strings.

Code Block
 "customdata": [{
                    "key": "keyName",
                    "value": "value"
                }, {
                    "key": "keyName2",
                    "value": "value2"
                }
            ]
Note

The maximum number of characters for the key is 20, and 256 for the value. The maximum number of custom key-value pairs per consent statement is 50.

No
descriptionstringA description of this consent object.
No
legalStatementsJSON object

An object containing the supported locales for this consent statement. Each locale includes the following fields:

  • purpose - (string) The purpose of the consent statement, this is publicly visible to the end-user.
  • documentUrl - (string) The URI location of the PDF that contains the consent statement for the defined locale.

Example:

Code Block
"en": {
    "purpose": "This is my purpose",
    "documentUrl": "https://www.site.com/doc_en.pdf"
},
"fr": {
	"purpose": "C'est mon but",
    "documentUrl": "https://www.site.com/doc_fr.pdf"
}

For a list of all supported locales, see Advanced Customizations and Localization. Note that legalStatements are not available via accounts.getAccountInfo and can only be viewed inside the Consent Vault.

No
requiredBooleanThis applies to the requirement of the isConsentGranted field of the Preferences object and defines whether consent is required.
No
tagsstringArray of strings

Additional information in the form of a list of tags that you would like to save in the consent vault for any consent collection interaction (Grant/Withdraw/Renew). Once set, this value can be viewed in the Consent Vault, or searched for in the audit log.

Notes:

  • This field is not available via accounts.getAccountInfo or accounts.search for consents granted prior to July 22nd, 2018.
  • Tags can not be edited once set, to update the tags for a user they must consent to a new version of the agreement with the new/additional tags.
No
formatstring

Defines whether the isConsentGranted field requires validation in order to be submitted. Possible values are:

  • true
  • false
  • any
No
writeAccessstring

Specifies whether to allow unsigned requests to write into this object. This property applies when using the accounts.setAccountInfo method, or when setting fields through the usage of a Screen-Set. The supported values are:

  • "serverOnly" (default) - Only signed requests coming from the server are allowed.

  • "clientCreate" - Unsigned requests coming from the client are allowed to write into this field, only if it wasn't set before.
  • "clientModify" - Unsigned requests coming from the client are allowed to write into this field and modify existing values.
No
minDocVersionfloatFor statements that are versioned by numbers: The lowest version number that a user can consent to and still be considered to have a valid consent statement assigned to their account.
No
minDocDatedateFor statements that are versioned by dates: The earliest version date that a user can consent to and still be considered to have a valid consent statement assigned to their account.
No
refreshIntervalintegerThe number of days since consent was previously given before requesting the user's re-consent.
No
entitlementsarray

An array of comma-separated strings, where each string is an entitlement to which the user granted consent.

Entitlements are a sub-set of each statement, and are used to add nuance to the general consent statement.

...