เกตเวย์ API คอนเวอร์ชั่นสำหรับ Control Plane API แบบหลายบัญชี: เอกสารอ้างอิง

การจัดการบัญชี

สร้างบัญชี

สร้างเกตเวย์สำหรับหลายบัญชี ซึ่งพาร์ทเนอร์หรือผู้ลงโฆษณาสามารถจัดการได้โดยขึ้นอยู่กับอินพุต

สกีมา

POST https://{capig_domain}/hub/graphql/ 
_________________________________________________________________________________________________________________
      
mutation CreateTenantMutation(
        $input: CreateTenantInput!
      ) {
        tenantMutations {
          createTenant(input: $input) {
            tenant {
              id
              name
              status
              canPartnerManage
              users {
                id
                email
                roles {
                    name
                    displayName
                }
                tenants {
                    id
                    name
                    status
                    canPartnerManage
                    availableRoles {
                        name
                        displayName
                    }
                }
                isSelf
                canBeDeleted
                defaultTenantId
              }
              availableRoles {
                name
                displayName
              }
              tenantUsage {
                  totalActivePixels
                  totalInactivePixels
                  totalPixels
                  tenantUsageByTraffic {
                    totalEventsReceived
                    totalPixelsWithTraffic
                    publishError
                    durationInHours,
                    lastUpdatedAt
                 }
              }
              canEditTenantSettingsInUI
              canViewTenantInUI
              canEditTenantSettingsInUI
            }
          }
        }
      }
 _________________________________________________________________________________________________________    
input CreateTenantInput {
    name: String!
    canPartnerManage: Boolean!
    adminEmail: String
    eventEnrichment: Boolean!
}
     

ช่อง

CreateTenantInput

การส่งคืน

CreateTenantResult

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

 mutation CreateTenantMutation(
        $input: CreateTenantInput!
      ) {
        tenantMutations {
          createTenant(input: $input) {
            tenant {
              id
              name
              status
              canPartnerManage
            }
          }
        }
      }

     

ตัวแปร

{
   "input": {
       "name": "TestAdvertiserViaAPI",
       "canPartnerManage": true,
       "eventEnrichment": true
       }
}
     

ตัวอย่างการตอบกลับ

{
   "data": {
       "tenantMutations": {
           "createTenant": {
               "tenant": {
                   "id": "hU2koC34",
                   "name": "TestAdvertiserViaAPI",
                   "status": 0,
                   "canPartnerManage": true
               }
           }
       }
   }
}
     

ลบบัญชี

ลบบัญชีผู้ลงโฆษณา

สกีมา

POST https://{capig_domain}/hub/graphql/ 
_________________________________________________________________________________________________________________
      
    mutation DeleteTenant($tenantId: String!) {
      tenantMutations {
        deleteTenant(tenantId: $tenantId)
      }
    }

 _________________________________________________________________________________________________________    
tenantId: String!
     

ช่อง

การส่งคืน

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

 mutation DeleteTenant($tenantId: String!) {
   tenantMutations {
   deleteTenant(tenantId: $tenantId)
   }
}
     

ตัวแปร

{
   "tenantId": "Tse53QtW"
}
     

ตัวอย่างการตอบกลับ

{
   "data": {
       "tenantMutations": {
           "deleteTenant": true
       }
   }
}
     

อัพเดตบัญชี

อัพเดตบัญชีด้วยชื่อ สถานะ และสิทธิ์การอนุญาตใหม่เพื่อให้พาร์ทเนอร์สามารถจัดการบัญชีได้

สกีมา

POST https://{capig_domain}/hub/graphql/ 
_________________________________________________________________________________________________________________
      
 mutation TenantEditNameModalMutation(
  $input: UpdateTenantInput!
) {
  tenantMutations {
    updateTenant(input: $input) {
        tenant {
            id
            name
            status
            canPartnerManage
            users {
                id
                email
                roles {
                    name
                    displayName
                }
                tenants {
                    id
                    name
                    status
                    canPartnerManage
                    availableRoles {
                        name
                        displayName
                    }
                }
                isSelf
                canBeDeleted
                defaultTenantId
            }
            availableRoles {
                name
                displayName
            }
            tenantUsage {
                totalActivePixels
                totalInactivePixels
                totalPixels
                tenantUsageByTraffic {
                   totalEventsReceived
                   totalPixelsWithTraffic
                   publishError
                   durationInHours,
                   lastUpdatedAt
               }
            }
            canEditTenantSettingsInUI
            canViewTenantInUI
            canEditTenantSettingsInUI
        }
    }
  }
}
      
_________________________________________________________________________________________________________    
input UpdateTenantInput {
    tenantId: String!
    name: String
    status: Int
    canPartnerManage: Boolean
}
     

ช่อง

UpdateTenantInput

การส่งคืน

TenantMutationResponse

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation TenantEditNameModalMutation(
 $input: UpdateTenantInput!
) {
 tenantMutations {
   updateTenant(input: $input) {
     tenant {
       id
       name
       status
       canPartnerManage
     }
   }
 }
}
     

ตัวแปร

{
   "input":{
       "tenantId":"IaoreXfj",
       "name":"Test Account Name Update",
       "status":0,
       "canPartnerManage":true
   }
}
     

ตัวอย่างการตอบกลับ

{
   "data": {
       "tenantMutations": {
           "updateTenant": {
               "tenant": {
                   "id": "IaoreXfj",
                   "name": "Test Account Name Update",
                   "status": 0,
                   "canPartnerManage": true
               }
           }
       }
   }
}
     

รับบัญชี

รับบัญชีผู้ลงโฆษณาที่เกี่ยวข้องกับอินพุตตัวระบุที่ไม่ซ้ำกัน

สกีมา

POST https://{capig_domain}/hub/graphql/ 
_________________________________________________________________________________________________________________
      
query TenantAccountUsersViewQuery(
  $tenantId: String!
) {
  tenant(tenantId: $tenantId)  {
        id
        name
        status
        canPartnerManage
        users {
            id
            email
            roles {
                name
                displayName
            }
            tenants {
                id
                name
                status
                canPartnerManage
                availableRoles {
                    name
                    displayName
                }
            }
            isSelf
            canBeDeleted
            defaultTenantId
        }
        availableRoles {
            name
            displayName
        }
        tenantUsage {
            totalActivePixels
            totalInactivePixels
            totalPixels
            tenantUsageByTraffic {
               totalEventsReceived
               totalPixelsWithTraffic
               publishError
               durationInHours,
               lastUpdatedAt
            }
        }
        canEditTenantSettingsInUI
        canViewTenantInUI
        canEditTenantSettingsInUI
    }
}
_________________________________________________________________________________________________________    
tenantId: String!
     

ช่อง

การส่งคืน

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การสืบค้น

query TenantAccountUsersViewQuery(
 $tenantId: String!
) {
 tenant(tenantId: $tenantId) {
   id
   name
   users {
     id
     email
     roles {
         name
         displayName
     }
   }
 }
}
     

ตัวแปร

{
   "tenantId":"wW58k7FQ"
}
     

ตัวอย่างการตอบกลับ

{
   "data": {
       "tenant": {
           "id": "wW58k7FQ",
           "name": "Test Account",
           "users": [
               {
                   "id": "992bc489-a799-4374-8933-0109eed60e3d",
                   "email": "tempuser@test.com",
                   "roles": [
                       {
                           "name": "advertiser-manage-wW58k7FQ",
                           "displayName": "manage"
                       }
                   ]
               }
           ]
       }
   }
}
     

การใช้งานบัญชี

รับข้อมูลการใช้งานบัญชี โดยจะเป็นข้อมูลพิกเซลที่กำลังใช้งานและไม่ได้ใช้งานซึ่งเกี่ยวข้องกับตัวระบุที่ไม่ซ้ำกันของบัญชี นอกจากนี้ ระบบจะส่งคืนสถิติการใช้งานการรับส่งข้อมูลในช่วงระยะเวลาหนึ่งด้วย

สกีมา

POST https://{capig_domain}/hub/graphql/ 
_________________________________________________________________________________________________________________
      
query TenantUsageQuery(
  $tenantId: String!
) {
    tenantUsage(tenantId: $tenantId) {
        totalActivePixels
        totalInactivePixels
        totalPixels
        tenantUsageByTraffic {
           totalEventsReceived
           totalPixelsWithTraffic
           publishError
           durationInHours,
           lastUpdatedAt
       }
    }
}

_________________________________________________________________________________________________________    
tenantId: String!
     

ช่อง

การส่งคืน

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การสืบค้น

query {
   tenantUsage(tenantId: "IaoreXfj"){
       totalActivePixels
       totalInactivePixels
       totalPixels
   }
}
     

ตัวอย่างการตอบกลับ

{
   "data": {
       "tenantUsage": {
           "totalActivePixels": 3,
           "totalInactivePixels": 1,
           "totalPixels": 4
       }
   }
}
     

ดูเพิ่มเติม

• เกตเวย์ API คอนเวอร์ชั่นสำหรับ Control Plane API แบบหลายบัญชี
• Control Plane API: เอกสารอ้างอิง
• เอกสารอ้างอิง Control Plane API: การจัดการผู้ใช้
• เอกสารอ้างอิง Control Plane API: การจัดการพิกเซล
• เอกสารอ้างอิง Control Plane API: การกำหนดค่าการกำหนดเส้นทางข้อมูลบัญชี
• เอกสารอ้างอิง Control Plane API: เกณฑ์ชี้วัดเหตุการณ์ในบัญชี
• เอกสารอ้างอิง Control Plane API: อ็อบเจ็กต์