Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stepio/jgforms
Support submitting Google Forms through Java API.
https://github.com/stepio/jgforms
google-forms java
Last synced: 3 months ago
JSON representation
Support submitting Google Forms through Java API.
- Host: GitHub
- URL: https://github.com/stepio/jgforms
- Owner: stepio
- License: apache-2.0
- Created: 2019-01-07T20:13:22.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-09-05T11:22:00.000Z (over 3 years ago)
- Last Synced: 2023-08-02T23:47:36.855Z (over 1 year ago)
- Topics: google-forms, java
- Language: Java
- Homepage:
- Size: 138 KB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# jgforms
[](https://travis-ci.com/stepio/jgforms)
[](https://sonarcloud.io/dashboard?id=stepio_jgforms)
[](https://app.codacy.com/app/stepio/jgforms?utm_source=github.com&utm_medium=referral&utm_content=stepio/jgforms&utm_campaign=Badge_Grade_Dashboard)
[](https://depshield.github.io)
[](https://mvnrepository.com/artifact/io.github.stepio.jgforms/jgforms)
[](http://www.javadoc.io/doc/io.github.stepio.jgforms/jgforms)
[](https://www.apache.org/licenses/LICENSE-2.0.txt)
Support submitting Google Forms through Java API. No third-party dependencies (except of test-scoped), compatible with Java 7 and Android.
Suppose you have a Google Form with next URL:
```properties
https://docs.google.com/forms/d/1Gn8J8I-5k-0qETKchs-P2UOs3kCU17uHs0GtqCklgLk/edit
```
This part is "form's key": `1Gn8J8I-5k-0qETKchs-P2UOs3kCU17uHs0GtqCklgLk`.
When you submit this form and check the resulting request through "DevTools", you can find next form data submitted:
```properties
entry.1464627081: 42
entry.786688631: This text is just dummy
entry.1117050788_year: 2019
entry.1117050788_month: 1
entry.1117050788_day: 10
entry.1117050788_hour: 11
entry.1117050788_minute: 46
entry.1536399354_hour: 09
entry.1536399354_minute: 23
entry.1536399354_second: 14
```
The above given numbers in each of the `entry.: value` lines identify the appropriate questions in your Google Form.
So while using the project you will need them along with the above mentioned form key.
To submit data to your form using this module, just follow next steps:
1. Add dependency to the [latest version](https://search.maven.org/search?q=g:io.github.stepio.jgforms%20AND%20a:jgforms&core=gav):
```xml
io.github.stepio.jgforms
jgforms
1.0.1
```
2. Describe metadata, matching your Google Form:
```java
public enum MyForm implements MetaData {
SOME_SHORT_TEXT(1464627081L),
MUCH_LONGER_TEXT(786688631L),
EXTRA_DATE(1117050788L),
SAMPLE_DURATION(1536399354L);
private long id;
JGForm(long id) {
this.id = id;
}
@Override
public long getId() {
return this.id;
}
}
```
3. Use metadata to prepare form data and construct `URL` object with it:
```java
Calendar date = Calendar.getInstance();
Calendar from = Calendar.getInstance();
from.set(date.get(Calendar.YEAR) - 1, date.get(Calendar.MONTH), date.get(Calendar.DAY_OF_MONTH), 1, 2, 3);
URL url = Builder.formKey("1FAIpQLScahJirT2sVrm0qDveeuiO1oZBJ5B7J0gdeI7UAZGohKEmi9g")
.put(MyForm.SOME_SHORT_TEXT, 42)
.put(MyForm.MUCH_LONGER_TEXT, "Any long text could be here")
.putDateTime(MyForm.EXTRA_DATE, date)
.putDuration(MyForm.SAMPLE_DURATION, from, date)
.toUrl();
```
The above given code generates next URL:
```properties
https://docs.google.com/forms/d/e/1FAIpQLScahJirT2sVrm0qDveeuiO1oZBJ5B7J0gdeI7UAZGohKEmi9g/formResponse?entry.1117050788_month=1&entry.1117050788_day=13&entry.1117050788_year=2019&entry.1536399354_minute=16&entry.1536399354_second=43&entry.1117050788_hour=14&entry.1117050788_minute=18&entry.786688631=Any+long+text+could+be+here&entry.1536399354_hour=13&entry.1464627081=42
```
4. Submit the form data:
```java
Submitter submitter = new Submitter(
new Configuration()
);
try {
submitter.submitForm(url);
} catch (NotSubmittedException ex) {
// TODO: log & handle the exception properly
}
```