Skip to content

This is a Java-based library useful to work with all Google's API services. Good use!

License

Notifications You must be signed in to change notification settings

N7ghtm4r3/GoogleManager

Repository files navigation

GoogleManager

v1.0.3

This is a Java Based library useful to work with Google API services

Implementation

Add the JitPack repository to your build file

Gradle

  • Add it in your root build.gradle at the end of repositories

    Gradle (Short)

    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }

    Gradle (Kotlin)

    repositories {
        ...
        maven("https://jitpack.io")
    }
  • Add the dependency

    Gradle (Short)

    dependencies {
        implementation 'com.github.N7ghtm4r3:GoogleManager:1.0.3'
    }

    Gradle (Kotlin)

    dependencies {
        implementation("com.github.N7ghtm4r3:GoogleManager:1.0.3")
    }

Maven

  • Add it in your root build.gradle at the end of repositories
<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
  • Add the dependency
<dependency>
  <groupId>com.github.N7ghtm4r3</groupId>
  <artifactId>GoogleManager</artifactId>
  <version>1.0.3</version>
</dependency>

🛠 Skills

  • Java

Services available

The other services will be gradually released

Initial configuration

Before to start you have to create or authorize, from Google API Console, the new project that you will use in this library:

  • Create a project to use in the library if you haven't one yet
  • Then you have to choose, and enable, the API services that you need from this page
  • After chosen the API services that you need, you have to configure consent screen to be allowed to use OAuth 2.0 Client IDs service (this library use only this as authentication mode)
  • After configured the consent screen, you have to create and configure OAuth client ID to copy the Client ID and the Client secret or download the JSON file with these credentials, in this case you need to parse by yourself to get the Client ID and the Client secret.
    Note: based on your choose for Application type you have to configure by yourself details such as host, port, callback path, etc
  • After these operations you and your project are ready to use GoogleManager library!

Usage/Examples

Execution

For any library manager you need to instantiate it like this:

// choose the manager for example: Gmail, etc 
GoogleManager manager = new GoogleManager(clientId,clientSecret,userId, /* params of the constructor chosen */);
// and then use it
manager.makeSomething();

To avoid re-entering credentials for each manager, you can instantiate managers like this:

// choose the manager for example: Gmail, etc 
GoogleManager firstManager = new GoogleManager(clientId,clientSecret,userId, /* params of the constructor chosen */);
// and then use it 
firstManager.makeSomething();
// you don't need to insert all credentials to make manager work
GoogleManager secondManager = new GoogleManager(); // same credentials used
// and then use it
secondManager.makeSomething();

Responses

Library give to you the opportunity to customize the return object after a request, the possibilities are:

  • JSON: return response formatted as JSON (org.json.JSONObject or org.json.JSONArray)
  • STRING: return response formatted as String
  • LIBRARY_OBJECT: return response formatted as custom object offered by GoogleManager's library

You find the constants in GoogleManager.ReturnFormat enum

// choose the manager for example: Gmail, etc 
GoogleManager manager = new GoogleManager(clientId,clientSecret,userId, /* params of the constructor chosen */);
// method to return directly a library given by library
manager.someRequest(); // in this case will be returned directly a LIBRARY_OBJECT
// method to customize the format of the return 
manager.someRequest(ReturnFormat.JSON); // in this case will be returned response in JSON format

Authors

Support

If you need help using the library or encounter any problems or bugs, please contact us via the following links:

Thank you for your help!

Badges

Twitter

Donations

If you want support project and developer

Crypto Address Network
3H3jyCzcRmnxroHthuXh22GXXSmizin2yp Bitcoin
0x1b45bc41efeb3ed655b078f95086f25fc83345c4 Ethereum

If you want support project and developer with PayPal

Copyright © 2024 Tecknobit