Getting Started¶
If you are new to the Altmetric Google BigQuery datasets environment, here is a list of steps necessary to get started.
- [1] Request Access
-
Access to Altmetric BigQuery datasets is not automatically provided and needs to be requested by raising a support ticket to [email protected]. Access is available to clients who have purchased the Altmetric BigQuery subscription as part of their license. Existing Altmetric Details Page or Explorer API users do not have access by default to the Altmetric BigQuery datasets. In the support ticket requesting Altmetric BigQuery access, please provide the following:
- Includes specific mention of Google BigQuery Access
- Your organisation's name.
- The name, email address, and position of the person who requires access.
The step below to create/choose a Google Account can be undertaken while awaiting the support ticket resolution.
- [2] Create/Choose a Google Account
-
A Google Account is required to access BigQuery and the Altmetric datasets on BigQuery, this is different and distinct from both the credentials used to access Altmetric, and different again to the credentials used for Explorer API or Details Page API access. Individual users who require access to the Altmetric BigQuery data sets are assigned access to a specific Google Account which they can nominate. An individuals' Google Account is provided access to the Altmetric BigQuery datasets rather than an entire organisation.
If your institution uses G Suite or G Suite for Education for email and/or collaboration you then have the option of reusing this existing account for accessing BigQuery. Otherwise it is necessary to use either an existing Google account or creating a new Google account.
Tip
You don't need a Gmail account to create a Google Account, you can use your non-Gmail email address to create one instead. During the account creation process just click 'Use my current email address instead' and enter the email address you wish to associate with your new Google Account.
- [3] User Invitation
-
After requesting access through a support ticket you will be provided a link that allows you to nominate the Google Account (as detailed above) that you wish to utilise for accessing the Altmetric BigQuery datasets. Following the steps outlined alongside the provided link will complete the signup process.
Once you have associated your Google Account and successfully confirmed these details, your nominated account will be provided with read access onto the BigQuery datasets. Read access is immediately provisioned and is provided through the Google Project
altmetric(a link to the project/datasets are provided at the end of the user signup process).Hint
For users who have completed the above steps, the Altmetric BigQuery data set can be found here: https://console.cloud.google.com/bigquery?p=altmetric&page=project
The next documentation section provides detailed information to get you started executing queries in the Google Cloud Platform.
Note
The Altmetric Google BigQuery data set is subscription-only, so your Altmetric account needs to be licensed for this service. Please send an email to [email protected] if you have any questions.