Hızlı Başlangıç: Azure İletişim Hizmetleri kullanarak telefon numarası için operatör bilgilerini arama

Telefon numaralarına ilişkin operatör bilgilerini aramak için JavaScript için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu kitaplık, bu telefon numarasıyla iletişim kurmak ve iletişim kurmak için kullanılabilir. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Node.js Etkin LTS (uzun vadeli destek) ve Bakım LTS sürümleri (8.11.1 ve 10.14.1 önerilir).
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde komutunu çalıştırarak node --version Node.js yüklenip yüklenmediğini denetleyin.

Ayarlama

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni Node.js Uygulaması oluşturma

Terminalde veya komut penceresinde uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Varsayılan ayarlarla bir package.json dosyası oluşturmak için komutunu çalıştırınnpm init -y.

npm init -y

Oluşturduğunuz dizinin kökünde number-lookup-quickstart.js adlı bir dosya oluşturun. Aşağıdaki kod parçacığını ekleyin:

async function main() {
    // quickstart code will go here
}

main();

paketini yükleyin

npm install JavaScript için Azure İletişim Hizmetleri Telefon Numbers istemci kitaplığını yüklemek için komutunu kullanın.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

seçeneği--save, kitaplığı package.json dosyanıza bağımlılık olarak ekler.

Kod örnekleri

İstemcinin kimliğini doğrulama

İstemci kitaplığından Telefon NumbersClient dosyasını içeri aktarın ve Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınabilen bağlantı dizesi örneği oluşturun. bağlantı dizesi kodunuzun içine düz metin eklemekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesi yönetmeyi öğrenin.

aşağıdaki kodu number-lookup-quickstart.js en üstüne ekleyin:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Telefon numarası biçimlendirmesi arama

Bir telefon numarasının operatör bilgilerini aramak için içinden PhoneNumbersClientarayınsearchOperatorInformation.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Bir sayı için işleç bilgilerini arama

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine includeAdditionalOperatorDetails ileterek true içinden PhoneNumbersClientarayınsearchOperatorInformation.

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz . SMS Hızlı Başlangıcı.

Kodu çalıştırma

Komutunu kullanarak node uygulamayı terminal veya komut pencerenizden çalıştırın.

node number-lookup-quickstart.js

Örnek kod

Örnek uygulamayı GitHub'dan indirebilirsiniz).

C# için Telefon Numaraları istemci kitaplığını kullanmaya başlayın ve bu telefon numarasıyla iletişim kurmak ve iletişim kurmak için kullanılabilecek telefon numaraları için operatör bilgilerini arayın. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• İşletim sisteminiz için .NET Core istemci kitaplığının en son sürümü.
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde komutunu çalıştırarak dotnet .NET SDK'sının yüklü olup olmadığını denetleyin.

Ayarlama

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni bir C# uygulaması oluşturma

Terminalde veya komut penceresinde komutunu çalıştırarak dotnet new adlı NumberLookupQuickstartyeni bir konsol uygulaması oluşturun. Bu komut, Program.cs tek bir kaynak dosyasıyla basit bir "Merhaba Dünya" C# projesi oluşturur.

dotnet new console -o NumberLookupQuickstart

Dizininizi yeni oluşturulan uygulama klasörüne değiştirin ve komutunu kullanarak dotnet build uygulamanızı derleyin.

cd NumberLookupQuickstart
dotnet build

Geliştirme paketi akışına Bağlan

SDK'nın genel önizleme sürümü bir geliştirme paketi akışında yayımlanır. Geliştirme akışını, NuGet.Config dosyasına ekleyen NuGet CLI'sini kullanarak ekleyebilirsiniz.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

Geliştirme akışına bağlanmak için daha ayrıntılı bilgiler ve diğer seçenekler katkıda bulunma kılavuzunda bulunabilir.

paketini yükleyin

Uygulama dizinindeyken, aşağıdaki komutu kullanarak .NET paketi için Azure İletişim Hizmetleri Telefon Numbers istemci kitaplığını yükleyin.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

Ad alanını eklemek Azure.Communication için Program.cs en üstüne bir using yönerge ekleyin.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

İşlev imzasını zaman uyumsuz olacak şekilde güncelleştirin Main .

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Kod örnekleri

İstemcinin kimliğini doğrulama

Telefon Numarası istemcileri, Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınan bağlantı dizesi kullanılarak doğrulanabilir. bağlantı dizesi kodunuzun içine düz metin eklemekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesi yönetmeyi öğrenin.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

Telefon Sayı istemcileri, Microsoft Entra kimlik doğrulamasıyla da kimlik doğrulaması yapabilir. Bu seçenekle, AZURE_CLIENT_SECRET, AZURE_CLIENT_IDve AZURE_TENANT_ID ortam değişkenlerinin kimlik doğrulaması için ayarlanması gerekir.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Telefon numarası biçimlendirmesi arama

Bir numaranın ulusal ve uluslararası biçimlendirmesini aramak için, içinden PhoneNumbersClientöğesini arayınSearchOperatorInformationAsync.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Bir sayı için işleç bilgilerini arama

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine IncludeAdditionalOperatorDetails ileterek true içinden PhoneNumbersClientarayınSearchOperatorInformationAsync.

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz . SMS Hızlı Başlangıcı.

Kodu çalıştırma

Komutunu kullanarak dotnet run uygulamayı terminal veya komut pencerenizden çalıştırın.

dotnet run --interactive

Örnek kod

Örnek uygulamayı GitHub'dan indirebilirsiniz.

Telefon numaralarının operatör bilgilerini aramak için Java için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu kitaplık, bu telefon numarasıyla iletişim kurmak ve iletişim kurmak için kullanılabilir. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Java Development Kit (JDK) sürüm 8 veya üzeri.
• Apache Maven.
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Maven'in yüklü olup olmadığını denetlemek için terminalde veya komut penceresinde komutunu çalıştırın mvn -v .

Ayarlama

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni java uygulaması oluşturma

Terminalde veya komut penceresinde Java uygulamanızı oluşturmak istediğiniz dizine gidin. Maven-archetype-quickstart şablonundan Java projesi oluşturmak için aşağıdaki komutu çalıştırın.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

'Oluştur' görevi ile aynı ada artifactIdsahip bir dizin oluşturur. Bu dizin altında, src/main/java dizini proje kaynak kodunu içerir, src/test/java directory test kaynağını içerir ve pom.xml dosya projenin Proje Nesne Modeli veya POM'dir.

Geliştirme paketi akışına Bağlan

SDK'nın genel önizleme sürümü bir geliştirme paketi akışında yayımlanır. Geliştirme akışına bağlanmak için, metin düzenleyicinizde pom.xml dosyasını açın ve geliştirme deponuzu hem pom.xml <repositories> <distributionManagement> hem de henüz yoksa ekleyebileceğiniz bölümlere ekleyin.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

settings.xml dosyasını${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Paketleme okuma ve yazma kapsamları içeren bir Kişisel Erişim Belirteci oluşturabilir ve etiketine <password> yapıştırabilirsiniz.

Geliştirme akışına bağlanmak için daha ayrıntılı bilgiler ve diğer seçenekler burada bulunabilir.

paketini yükleyin

aşağıdaki bağımlılık öğelerini pom.xml dosyasındaki bağımlılık grubuna ekleyin.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0-beta.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

properties Projenizin Maven sürüm 1.8 veya üzerini hedeflediğinden emin olmak için bölümüne bakın.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Kod örnekleri

Uygulama çerçevesini ayarlama

Proje dizininden:

1. /src/main/java/com/communication/lookup/quickstart dizinine gidin
2. App.java dosyasını düzenleyicinizde açma
3. deyimini System.out.println("Hello world!"); değiştirme
4. Yönerge ekleme import

Başlamak için aşağıdaki kodu kullanın:

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

İstemcinin kimliğini doğrulama

İstemcinin kimliği, Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınan bağlantı dizesi kullanılarak doğrulanabilir. bağlantı dizesi kodunuzun içine düz metin eklemekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesi yönetmeyi öğrenin.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Alternatif olarak, Microsoft Entra kimlik doğrulamasını kullanarak kimlik doğrulaması yapabilirsiniz. DefaultAzureCredentialBuilder Microsoft Entra Id kullanmaya başlamanın en kolay yolu, öğesini kullanmaktır. Kaynak adınızı Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alabilirsiniz.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Telefon numarası biçimlendirmesi arama

Bir numaranın ulusal ve uluslararası biçimlendirmesini aramak için, içinden PhoneNumbersClientöğesini arayınsearchOperatorInformation.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Bir sayı için işleç bilgilerini arama

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine IncludeAdditionalOperatorDetails ileterek true içinden PhoneNumbersClientarayınsearchOperatorInformationWithResponse.

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz . SMS Hızlı Başlangıcı.

Kodu çalıştırma

Uygulamayı terminal veya komut pencerenizden aşağıdaki komutlarla çalıştırın: pom.xml dosyasını içeren dizine gidin ve projeyi derleyin.

mvn compile

Ardından paketi derleyin.

mvn package

Uygulamayı yürütmek için komutunu kullanın mvn .

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Örnek kod

Örnek uygulamayı GitHub'dan indirebilirsiniz.

Telefon numaraları için operatör bilgilerini aramak için Python için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu kitaplık, bu telefon numarasıyla iletişim kurup iletişim kurmayacağını ve nasıl iletişim kurabileceğinizi belirlemek için kullanılabilir. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Python 3.7+.
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde, Python'ın yüklü olup olmadığını denetlemek için komutunu çalıştırın python --version .

Ayarlama

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni Python uygulaması oluşturma

Terminalde veya komut penceresinde uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Proje kök dizininde adlı number_lookup_sample.py bir dosya oluşturmak ve aşağıdaki kodu eklemek için bir metin düzenleyicisi kullanın. Kalan hızlı başlangıç kodu aşağıdaki bölümlerde eklenmiştir.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

paketini yükleyin

Uygulama dizinindeyken komutunu kullanarak Python paketi için Azure İletişim Hizmetleri Telefon Numbers istemci kitaplığını pip install yükleyin.

pip install azure-communication-phonenumbers==1.2.0b2

Kod örnekleri

İstemcinin kimliğini doğrulama

İstemcinin kimliği, Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınan bağlantı dizesi kullanılarak doğrulanabilir. bağlantı dizesi kodunuzun içine düz metin eklemekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesi yönetmeyi öğrenin.

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Alternatif olarak, istemcinin kimliği Microsoft Entra kimlik doğrulaması kullanılarak doğrulanabilir. DefaultAzureCredential Nesnesini kullanmak, Microsoft Entra Id kullanmaya başlamanın en kolay yoludur ve komutunu kullanarak pip install yükleyebilirsiniz.

pip install azure-identity

DefaultAzureCredential Nesne oluşturmak için AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, ve AZURE_TENANT_ID zaten kayıtlı Microsoft Entra uygulamanızdan karşılık gelen değerleriyle ortam değişkenleri olarak ayarlamanız gerekir.

Bu ortam değişkenlerini alma hakkında bilgi edinmek için CLI'dan hizmet sorumlularını ayarlamayı öğrenebilirsiniz.

azure-identity Kitaplık yüklendikten sonra istemcinin kimliğini doğrulamaya devam edebilirsiniz.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Telefon numarası biçimlendirmesi arama

Bir numaranın ulusal ve uluslararası biçimlendirmesini aramak için, içinden PhoneNumbersClientöğesini arayınsearch_operator_information.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Bir sayı için işleç bilgilerini arama

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine include_additional_operator_details ileterek True içinden PhoneNumbersClientarayınsearch_operator_information.

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz . SMS Hızlı Başlangıcı.

Kodu çalıştırma

Komutunu kullanarak python uygulamayı terminal veya komut pencerenizden çalıştırın.

python number_lookup_sample.py

Örnek kod

Örnek uygulamayı GitHub'dan indirebilirsiniz.