data.md

Data

Learn more about how to get access to user information.

• Introduction
• ON_PERMISSION
• Name
• Location
• Account Linking

Introduction

User information is mainly used to offer a more personalized experience, but you can't access it right away. First you have to ask for permission.

ON_PERMISSION

After the user has answered your request, they will be redirected to the ON_PERMISSION intent, if availabe, where you can access and store the data.

ON_PERMISSION() {
  
}

Name

You can get access to the user's given name, family name and display name.

// Ask for permission
this.$googleAction.askForName(speech);

ON_PERMISSION() {
  if (this.$googleAction.isPermissionGranted()) {
    let user = this.$googleAction.$request.getUser();

    // Check, if you have the necessary permission
    if (user.permissions.indexOf('NAME') > -1) {
      /* 
        user.profile.givenName
        user.profile.familyName
        user.profile.displayName
      */
    }
  }
}

Location

Get access to the user's location. Depending on the device the request comes from and the permission you have, you can get access to different data.

If it's a phone, you can only access the latitude and longitude with the DEVICE_PRECISE_LOCATION permission.

On a voice-enabled speaker you can access all of the data, depending on the permission you have.

this.$googleAction.askForPreciseLocation(speech);

this.$googleAction.askForZipCodeAndCity(speech);

ON_PERMISSION() {
  if (this.$googleAction.isPermissionGranted()) {
    let user = this.$googleAction.$request.getUser();

    if (user.permissions.indexOf('DEVICE_COARSE_LOCATION') > -1) {
      let device = this.$googleAction.$request.getDevice();
      /*
        device.location.city
        device.location.zipCode
      */
    }
    if (user.permissions.indexOf('DEVICE_PRECISE_LOCATION') > -1) {
      let device = this.$googleAction.$request.getDevice();
      /*
        device.location.coordinates.latitude
        device.location.coordinates.longitude
        device.location.formattedAddress
        device.location.city
        device.location.zipCode
      */
    }
  } else {
    this.tell('Alright, maybe next time');
  }
},

Official Documentation

Example

Account Linking

You can find the documentation about Account Linking here: App Logic > Data