SAP Analytics Cloud - API Access documentation

[mateusz_mikulski]

Hi,

I am trying to find a documentation for SAC API access (for new OAuth Client). There are 6 different accesses and I am able to find only short description for two of them (in this help page).

Story Listing: This OAuth client privilege allows a third-party application to access a list of stories in your system.

User Provisioning: This OAuth client privilege allows a third-party application to manage users in your system.

What's about the rest (screen below)? Any chance to find an official documentation from SAP (or I need to paid for that :)) ?

[alexeydugarov · Accepted solution]

Hi Mateusz!

I agree, this is not clear. I've tried to find help. Catch the link: https://help.sap.com/viewer/product/SAP_ANALYTICS_CLOUD/release/en-US?q=API

My suggetions:

1. Analytics Content - SAP Analytics Cloud Content Network REST API Developer Guide
2. Modelling - Using Version Management APIs on Data Models for SAP Analytics Cloud
3. Resource permissions - /Resources goes to SAP Analytics Cloud Tenant API (section Resources)
   
4. Story listing - api/v1/stories
5. Translation service - I haven't find an API specification but there is a Translation capabilities and Multilingual Support. May it will be posted after Q3 relese is alive (planned at the end of August)?
6. User provision - SAP Analytics Cloud User and Team Provisioning API

[TuncayKaraca · Accepted solution]

Hi Alexey and Mateusz,

Great findings, thanks for sharing!

I don't think #2 Modelling - Using Version Management APIs on Data Models for SAP Analytics Cloud is for OAuth usage. Any API related to Analytics Applications / Analytics Designer Scripting is not for OAuth (third party access); that my understanding!

Regards,
Tuncay

[mateusz_mikulski · Accepted solution]

Thanks Alexey!

For sure I will review your links, and many thanks for gathering them!

Nevertheless, it is not professional from SAP side to just not document part of the software (especially as this is quite expensive). I hope working on proper documentation is somewhere in SAC roadmap and there is internal JIRA ticket in progress now...

Best Regards,

Mateusz

[Matthew_Shaw]

Can I recommend my blog which introduces the SCIM API best practices and sample scripts?

You'll find my best practices article introduces all the official links here (for all parts of the SCIM API) and then goes into all the details for the user management part of the SCIM API. The sample scripts article, then provides that best practices actually implemented for you with Postman with scripts to do just about everything the API offers. It means you can be up and running using the API in about 40 minutes by following my user guide from the blog I just mentioned.

The user guide also has a link to the Content Network API which isn't part of the SCIM API

Let others know by posting to my blog if you find it helpful!

All the best, Matthew

[mateusz_mikulski]

Hi Matthew, of course, I know your post, a very good compendium for Users and Teams Provisioning. However, perhaps you remember, that we are using SAP IDM to create SAC users and assign them to teams, so this is not an API I would like to use.

I want to monitor SAC with an external system (SAP Analytics Cloud monitoring), DataDog, and I can use the API and post request - working pretty fine. I've used Story Listing access for that, but I was wondering when to use which option from OAuth Client and I really struggle to find the documentation.

I think it is really weird that it is not included in the SAC documentation. OAuth client is not a new feature.

In general, sorry to say that, but SAC documentation is disappointing. And not complete. A lot of stuff is just not documented... Just to mentioned SAP Cloud Agent. Even for example the Q3.2021 release - something was changed in roles, also the way to import / export content is different now. That was a surprise on Monday when our SAC developers were not able to import content to the production tenant... It was never mentioned in those fancy posts about what's new in SAC. Perhaps it was not impressive enugh.

Best regards,

Mateusz

[dvankempen]

For the interested reader, we have started to record a video tutorial series about the SAP Analytics Cloud user and team provisioning API

• https://blogs.sap.com/2021/09/25/sap-analytics-cloud-user-and-team-provisioning-api-hands-on-video-t...

[Matthew_Shaw]

Hi Mateusz,

I can see you're struggling here, but perhaps for good reason. I'm not aware of any SAP solution that addresses this need and hence no documentation on it. Though one of our wonderful partners have a solution (apos-insight-for-cloud) that appears to be possible fit:

Let us know how you get on.

Best regards, Matthew