Een Google Ads-basisverbinding maken met de Flow Service API

WARNING
De Google Ads bron is tijdelijk niet beschikbaar. Adobe werkt aan het oplossen van problemen met deze bron.
NOTE
De Google Ads-bron is bèta. Zie de Overzicht van bronnen voor meer informatie over het gebruik van bronnen met een bètalabel.

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

In deze zelfstudie worden de stappen doorlopen waarmee u een basisverbinding voor Google Ads kunt maken met de opdracht Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met behulp van de services van Experience Platforms.
  • Sandboxen: Experience Platform biedt virtuele sandboxen die één Experience Platform-instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

In de volgende secties vindt u aanvullende informatie die u nodig hebt om verbinding te kunnen maken met Google Ads via de Flow Service API.

Vereiste referenties verzamelen

Om Flow Service Als u verbinding wilt maken met Google Ads, moet u waarden opgeven voor de volgende verbindingseigenschappen:

Credentials
Beschrijving
clientCustomerId
De client-id is het accountnummer dat overeenkomt met de Google Ads-clientaccount die u wilt beheren met de Google Ads-API. Deze id volgt de sjabloon van 123-456-7890.
loginCustomerId
De inlogklant-id is het accountnummer dat overeenkomt met uw Google Ads Manager-account en wordt gebruikt om rapportgegevens van een specifieke operationele klant op te halen. Voor meer informatie over de login identiteitskaart van de klant Google Ads API-documentatie.
developerToken
Met de ontwikkelaarstoken hebt u toegang tot de API voor Google Ads. U kunt dezelfde ontwikkelaarstoken gebruiken om aanvragen in te dienen voor al uw Google Ads-accounts. Haal de ontwikkelaarstoken op door aanmelden bij uw beheerdersaccount en navigeert vervolgens naar de API Center pagina.
refreshToken
Het token Vernieuwen maakt deel uit van OAuth2 verificatie. Dit teken staat u toe om uw toegangstokens na het verlopen opnieuw te produceren.
clientId
De client-id wordt gebruikt in combinatie met het clientgeheim als onderdeel van OAuth2 verificatie. Met de client-id en het clientgeheim kan uw toepassing samen namens uw account werken door uw toepassing te identificeren bij Google.
clientSecret
Het clientgeheim wordt gebruikt in combinatie met de client-id als onderdeel van OAuth2 verificatie. Met de client-id en het clientgeheim kan uw toepassing samen namens uw account werken door uw toepassing te identificeren bij Google.
connectionSpec.id
De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Google Ads is: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Het API-overzichtsdocument lezen voor meer informatie over hoe je aan de slag gaat met Google Ads.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op aan de slag met platform-API's.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections eindpunt terwijl het verstrekken van uw de authentificatiegeloofsbrieven van Google Adds als deel van de verzoekparameters.

API-indeling

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor Google Ads gemaakt:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "authenticationType": "{AUTHENTICATION_TYPE}"
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "refreshToken": "{REFRESH_TOKEN}"
          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'
Eigenschap
Beschrijving
auth.params.clientCustomerID
De client-id van je Google Ads-account.
auth.params.loginCustomerID
De aanmeldings-id die overeenkomt met uw Google Ads Manager-account.
auth.params.developerToken
De ontwikkelaarstoken van uw Google Ads-account.
auth.params.refreshToken
Het token Vernieuwen van je Google Ads-account.
auth.params.clientID
De client-id van je Google Ads-account.
auth.params.clientSecret
Het clientgeheim van je Google Ads-account.
connectionSpec.id
De Google Ads-verbindingsspecificatie-id: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Antwoord

Een succesvolle reactie retourneert details van de zojuist gemaakte basisverbinding, inclusief de unieke id (id). Deze id is vereist in de volgende stap om een bronverbinding te maken.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Google Ads-basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089