feat: add additional scopes request

[reslear]

Feature for simple request adding/removing additional scopes already authorised user

addScopes

• ts types
• Web
• Android
• iOS
• docs

removeScopes

• ts types
• Web
• Android
• iOS
• docs

closes: #158

[reslear]

hi @joeflateau need you help with this, and is need sponsoring you work)
separate function from

CapacitorGoogleAuth/ios/Plugin/Plugin.swift

Lines 67 to 73 in 27f0111

	self.googleSignIn.addScopes(self.additionalScopes, presenting: presentingVc) { user, error in
	if let error = error {
	self.signInCall?.reject(error.localizedDescription);
	return;
	}
	self.resolveSignInCallWith(user: user!);
	}

[joeflateau]

@reslear agree it would be good to add the "addScope" function, but I don't believe that would close #158, they seem unrelated.

[reslear]

@joeflateau #158 is example, but in my case need get google contacts from address book

In my onboarding screen app, login with google is required, is i'm set scopes

['profile', 'email', 'openid', 'https://www.googleapis.com/auth/contacts.readonly']

most people don't share contacts and leave the app 😨

but if we logged in a user with default areas ['profile', 'email', 'openid'], and somewhere in the application we made an optional button to share contacts

async function getContacts() { 
  
  // TODO: maybe need add checkScopes ?
  await GoogleAuth.addScopes([
    'https://www.googleapis.com/auth/contacts.readonly'
  ])

  const { result } = await gapi.client.people.people.connections.list({
     'resourceName': 'people/me',
     'personFields': 'names',
   })
   
   return result.connections.map((person) => person.names[0].displayName)
}

[reslear]

web https://developers.google.com/identity/sign-in/web/incremental-auth#step_2_request_additional_scopes

[reslear]

@hoi4 maybe you help for this?