Retour à l’accueil

Guide de configuration des clés API

Connectez App Store Connect et Google Play via invitation (plus simple) ou en important vos propres credentials API.

1. Apple App Store Connect

Deux chemins : inviter l’Apple ID Nicodesk (recommandé), ou importer votre propre clé API (.p8)

Option A — Inviter Nicodesk (recommandé)

  1. Dans Settings, ajoutez un compte iOS et choisissez Invite Nicodesk.
  2. Copiez l’e-mail Apple ID affiché, puis dans App Store Connect → Users and Access invitez cet e-mail avec Admin ou Finance.
  3. Saisissez votre Vendor Number et enregistrez. Le statut reste Invite pending jusqu’à ce que Nicodesk accepte l’e-mail et attache un .p8.
  4. L’Apple ID invité reçoit un vrai e-mail et doit l’accepter (contrairement aux comptes de service Google).

Option B — Votre propre clé API (.p8)

  1. Connectez-vous à App Store Connect → Users and Access > Keys.
  2. Générez une clé API nommée Nicodesk Metric Fetcher avec Admin (requis pour répondre aux avis ; Finance suffit pour les rapports de ventes seuls). Les clés Customer Support peuvent lire les avis mais ne peuvent souvent pas y répondre via l’API sans le bon scope.
  3. Copiez Issuer ID et Key ID, téléchargez le .p8 (une seule fois), et trouvez votre Vendor Number sous Reports → Sales and Trends.
  4. Dans Nicodesk Settings, choisissez My API key et collez Issuer, Key ID, Vendor Number et le .p8.
Exemple de configuration de clé App Store Connect (Option B)
Issuer ID:     a1b2c3d4-e5f6-7890-abcd-ef1234567890
Key ID:        YD3ZXUCHQA
Vendor Number: 89123456
Private Key:   -----BEGIN PRIVATE KEY----- ... -----END PRIVATE KEY-----

2. Google Play

Deux chemins : inviter Nicodesk (sans JSON, recommandé), ou utiliser votre propre JSON de compte de service

Option A — Inviter Nicodesk (recommandé)

  1. Dans Settings, ajoutez un compte Android et choisissez Invite Nicodesk.
  2. Copiez l’e-mail du compte de service affiché, puis ouvrez Google Play Console > Users and permissions et invitez cet e-mail au niveau du compte. Il n’y a aucun e-mail à accepter — les comptes de service n’ont pas de boîte de réception.
  3. Accordez au minimum View app information and download bulk reports et View financial data sous Account permissions (Global) — pas seulement des permissions par app. Pour Nicodesk Reviews (liste + réponse), activez aussi l’Android Publisher API et donnez au compte de service la permission de répondre aux avis / gérer la présence store selon vos besoins.
  4. Collez l’id du bucket Cloud Storage depuis Download reports (pubsite_prod_rev_… ou parfois pubsite_prod_…) et testez.

Option B — Votre propre JSON de compte de service (si l’invite reste en 403)

  1. Dans Play Console allez dans Setup → API access et confirmez le projet Cloud lié.
  2. Activez Google Play Android Developer API sur ce projet (Library).
  3. Cliquez Create service account, suivez le lien Cloud Console, créez le SA (ex. nicodesk-play-sync), puis Keys → Add Key → JSON.
  4. Retournez dans Play API access, cliquez Done, puis Grant access au niveau du compte avec bulk reports + financial data. Créer le SA depuis ce flux Play évite les SA « fantômes » qui n’obtiennent jamais l’ACL GCS.
  5. Vérifiez avec gcloud storage ls gs://pubsite_prod_rev_…/ en utilisant ce JSON. Quand les dossiers s’affichent, collez le JSON + l’id du bucket dans Nicodesk Settings → My service account (pubsite_prod_rev_… ou pubsite_prod_…).
Si vous obtenez un 403 sur Cloud Storage

L’ACL GCS peut prendre de quelques minutes à 24 h après une invitation au niveau du compte. Un 403 sur storage.objects.list avec un token valide signifie en général que Play n’a pas encore accordé l’ACL du bucket au SA (même erreur avec gcloud / curl). D’abord : activez Google Play Android Developer API. Si le 403 persiste, recréez le SA depuis Play → API access (pas un SA Cloud IAM autonome). Utilisez aussi le bucket Download reports de vos apps (souvent pubsite_prod_rev_…) — un 403 sur un autre id pubsite_prod_… ne prouve pas que le bucket rev a échoué.